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MODULE FUNCTION 
This REQUIRE file describes the structure of the Debug Bf ot Table 
enerated by the VAX compilers and interpreted by the Debugger. 
t includes ae Maltions for all field names and iterals used in 
building or interpreting the Debug Symbol Table (DST) 


DISCLAIMER 

This interface is not suppor.ted by Digital. watts the pebug, Symbol 
Table interface is believed to be correctly described here, Digital 
does not. guarantee that fre concr ios’ ne in sore Corin sion file are 
correct and comp lete. Also le this interf ace S$ expected to be 
responsbty stab £95 across = Reb Digital sernes yerentes, that 
will not change in future releases of VAX DE DEGUG S.t be VAX 
compilers, or other, sptfuere. incompatible. ble additions this 
interface are more Likely than neon atible changes, “but "ind viduals 
and organizations who use this Rg titate Hy eyes their 
work will be partial y or wholly inval future rel - es 0 
VAX DEBUG or other D 2 ital so teare. os A, Feserves the r ght to 
make future incompatible changes to the Debug Symbol Table interface. 
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PURPOSE OF THE DEBUG SYMBOL TABLE 


The Debug Symbol Table (DST) is the symbol table that the VAX compilers 
© pass symbol table information to the VAX penugeer and to the 

AX Traceback facility. The DST is a senguege- inegpenden symbol table 
n the sense that all VAX compilers output symbol arer eel tee in the 
same format, régardless of source language. This symbol information is 
emitted into the object modules produced 7 the compiler. It is epee 
passed through the Linker into the executabl -_ file that the Linker 
enerates EBUG or TRACEBACK can then retrieve the symbol information 
rom the image file. 


The purpose of the Debug Fymvet Table is thus to permit the Uresebech 
facility to give a symbolic stack dump on abnormal program termination 
and to permit DEBUG to purport fully syabo} tc debugging. Other Digital 
software may also use the DST information for various purposes. 


To support these purposes, the pebug Symbol Table represents all major 
aspects of program structure and data representation. It can represent 
modules, routines, lexical blocks, labels, and data symbols and it can 
represent qt nesting retatvonenige between such symbols. It can also 
describe Line number and source line information. It can describe all 
data types supported by DEBUG, eng Luding complex types such as record 
structures and enumeration types. In addition, it can describe arbi- 
trarily complex value and address computations. 


The Debug Symbol Table is solely intended to eupsers compiled Languages, 
not interpreted languages. The DST representation assumes that source 
Lines have been compiled into VAX instructions and that those instruc- 
tions are actuality executed, not interpreted. Such DEBUG facilitiés as 
breakpoints and single-stepping will not work if this assumption is 
violated. Similarly, it is assumed that data objects have addresses ‘ 
that can be accessed directly when these objects are examined or depo- 
sited into. DST information is thus ponerates | all compilers that 
ym ae Byeper ts. but not by the interpreters for languages such as 

or a 
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GENERAL STRUCTURE OF THE DST 


This section describes the general structure of the Debug Symbol Table. 
it explains how the DST is generated by the yer tous VAX compilers, how 
t is passed along to the erecytapte sege file by the Linker, and how 
it is accesses in the image file by DEBUG or TRACEBACK. This section 
also describes in general terms how the DST is structured internally: 
how it is subdivided ante modules, routines, lexical blocks, and indi- 
vidual symbols, how nesting relationsh ps are represented, and how data 
symbols, inc Luding their values and data t pes. are represented. The 
exact formats of the various Debug Symbol Tab coords and other fine- 
rained detail are described later in this definition file, not here, 
ut the goerse structure of the DST and how that structure is accessed 
are outlined in this section. 


MEAN ODONOUNE 


GENERATION OF THE DST 


The Debug Symbol Table (DST) is generated by the compilers for all VAX 
Languages Suppersed by DEBUG. . During compilation, the compiler outputs 
the DST for the module being compiled into the corresponding object 
file. When the Linker is invoked, it does relocation and global-symbol 
resolution on the DST text and then outputs it into the executable image 
file. Beyond knowing what must be relocated, the Linker has no specia 
knowledge of the format or contents of the DST. Finally, the Debugger 

* reads the DST information from the executable image file during a debug- 
ging session, or Traceback reads it when giving a traceback in response 
o an unhandled severe exception during image execution. 


A compiler outputs DST information in the form of two kinds of object 
records, TBT records and DBT records. (See the Linker manual for a 
full description of the VAX object -anquage accepted by the linker.) 
ALL “‘traceback"’ information goes into the TBT records and all ‘'symbol’’ — 
information goes into the DBT records. When the user later Links using 
the plain LINK command, only the DST information in the TBT records are 
copied to the executable image file. These records contain enough in- 
formation for Traceback to give a call-stack traceback. If the user 
Links with the LINK/DEBUG command, all information in both the TBT and 
the DBT records are copied to the executable image file. These records 
together give pt pst nyormas ion needed for ryt pympot fc debugging. 
The user can also Link with LINK/NOTRACEBACK, in which case no DST in- 
formation at all is copied to the executable image file. 


It is not possible to have the Linker copy the DBT records without also 
copying the TBT records; the information in the TBT records is required 
for the information in the DBT records to make sense. 


The ‘‘traceback"’ information in the TBT records includes all Module Begi 
and End DST records, all Routine Begin and End DST records, ail Lexical 
Block Begin and End DST records, and all Line Number PC-Correlation DST 
records. It ney also include Version Number DST records. All other DS 
e included in DBT records. 
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compiler. /DEBUG=(NOTRACE ,NOSYMBOL) causes no DST informat 
output at all. hag WE /BEBUG=(NOTRACE, SYMBOLS) causes all DS 
mation except Line Number PC-Correlation DST records to be output (this 
combination is pargety pointless although it saves some DST space). 
Note that the module, routine, and lexical block information, whic 
counts as traceback information, must be output if any symbol informa- 
t on tg Sutpus since it defines the scopes within which other symbols 
are defined. 


COOCCCOCSCCOO 


file, it may also output two more 

Table (GST) and the Debug Module Table (DMT). These two tables are 

enerated if the LINK/DEBUG command is used, not otherwise. The Global 
l bal symbols known to the Linker 


module containing some global symbol was compiled without DST informa- 
tion being output or because the module is not set (with SET MODULE) in 
the current debugging session. The GST information is not as complete 
as the DST information for the same symbols because the GST has no type 
description (the Linker does not need to know about data types). 


The Debug Module Table (DMT) is an indexing structure for the DST. It 
contains one record for each module in the DST. This record contains 

a@ pointer to the start of the DST for the corresponding module, the size 
of the DST for that module, the number of PSECTs in that module, and the 
address ranges of all those PSECTs. The DMT allows DEBUG to initialize 
its Module Table and its Static Address Table without actually Rev ing to 
read through the entire DST; because the DMT is very small compared to 
the DST, it can be scanned much more efficiently. 


The details of how the DST, the GST, and the DMT are accessed in the 
executable image file are explained in the next section. 
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LOCATION OF THE DST WITHIN THE IMAGE FILE 


The Debug S$ yabot Table is peceuese _throuse m gotnter information + pl in 
se executad mage hb header et kK 
pesae ager in e. fixed location 

lock Later in the header which oives the size and location of the 
pooup Syapet Table (Ds), he Global ymbol fable (GST), and the Debug 


Modu able (DMT). The first part of the executable image file header 
looks as follows: 
teomweoce wow ewoew wee eeowennne See rr, + 

long i ' 
toeoeoceroscoescc=s eee eeeeoeesoese eee tp¢oooeeeoescec= Secoceeeoeoseseseess + 

long } H “THDSW_. SYMDBGOF F H 
$eowwwooonone Seem ewww ewe www wwn peewee eco oeeesoeccecce wr cce ween} 

Long t. 

ee H Pee atlerahatnibiaesnittitaaie tks Fr BSS aE NS SE Reet IO lt ae > 


Here JHD$SW_SYMDBGOFF contains the byte offset rejettve to the start of 
the header of an Image Header Symbol Table Descri psec: The Image Header 
Symbol Table Descriptor (IHS) in turn has the following format: 


ewer ese eee ee ee ee eee ee ee ee ew ee me meee meme mem ewe eocces eee eee ewe eee ye 


af ORAS aR H 
sated EADIE a, ahs «ao EE ol OE ; 
ied an Licechsimaleetoeeereniiiatin ; 
ae Tl cestiabadinindiialanpanmanaserstie eee ctibicaumaanacumataianateed : 
ty BE PGE AS a, a al te Ra oe AD H 


Here IHS$W_DSTBLKS ne JuSSL _DSTVBN give the size. cin blocks) and loca- 
tion (VirtGal Block Number) Of the Debu syebos .! e (DST) within the 
execu 4 | image file. The fields ttt TREC + y IHSS$L GSTVBN ive 
the size (in G 1 records) and start location (Virtual Block 
the Global Symbol Table (GST). Finally, the fields IHSS$L parovirs and 
IHSSL_DMTVBN give the size (in bytes) ene start location (Virtua 
Number) of ed > bebus meee Table (DMT The DMT is described below. 
These fiel es are dgcle red by nacroj in SYSSLIBRARY : LIB 2. The 
symbol IHD we SYMDBGOFF is also defined in SYSSLIGRARY:LIB.L3 


Pointers to the Image Header and the Image Header Symbol Table Descrip- 
tor are declared as follows: 


IHDPTR: REF BLOCKC BYTE) 


Ho rc 


DONAULS WO OONO 


CODDODWDDDo ys 


SESseosesess 
RONLSSSLISPEL IS 


oO 
uw 


S& 
DOOOODOOSOOOSOSOSOSSSOSSOGSSOSSSSSSOSSOSSOSOSOSSOSOSOSSGOOOSSSSOSOSOOSSOSOSSSDO 


OoOCooo COOCCSOO 
PPPRRRLLLLLLSLLLLELLL LAG GORS COOLS. 
ee ed ed od ot ot =I OOO 


AWIPPOPPOPoNnonoNnofnofnyd 


ener 


ee ee EE EE EE EEE EEE EEE ETE EEE EEE EEE a a ae ae te ee ae 


RO OONO UES WIN (OO OONOU SW O0O@ 


WSoseoct9Rs 25:09:08 vatsIT BLigs-32 4.02742 Page 9 
IHSPTR: REF BLOCKCIWSSK LENGTH BYTE) 


The Image File Header in an saveuteste pe e file points to the Image 
Header seer lL Table descriptor as sees bed. . ov lf f bit 5 of tietd 


IHDSL_LNKFLAGS in she. s*8 e sheader: set a Mew ins e, i.e. 

one ria by the aelsi or tater | TH and the [HS$ _DMTVBN and 

HGS DMIBYTES f elds. on + hs the oh aheg Header Symbol Yop @ descriptor. 
5 is not set, mage and those fields do not 


the fa! file of the Debug Module Table (th DMTBYTES 
then gives the size of the DMT in bytes. the OM . Built if the 
weer eve a LINK/DEBUG; if he did not, IHS$L_DMTVBN and Mihsst _DMTBYTES 


The Debug Module Ta 
Symbol Table (the D 


an 
selet If te"of che esau "DMTVBN. ves the Ayla Tneet Number in 


ble contains one entry per module in the Debug 
ST). This is the format of each such DMT entry: 


H DST address of Module Begin DST Record 


trom e eee © ee ee ee eee ee en ewes eee nee ee ee meer eoem em mowers mae comme ase 


H Size in bytes of module’ : “DST 


beer eee ee rw n ee en ene ee. trem meeeoeewoefoeeoeces weewcenen es seme eee mew eoece. 


! Unused--Must _Be Zero wunber of PSECTS for module 


$eecwwececeeoweeeeweweeeowweeowewoewewwescooweseececoccoeccccoce 


Longword 0 gives the address relative to the start of the DST of the 
ure Begin DST Record for this module. Longword 2 fi gives the size 
of the DS fn bytes for fhe same module. Longwor ives the number 

of PSECTS in the module ( the number of atat cally ot Leceres 
program sections), and this "15 ollowed by that number’ o f two-longword 
perre wh ugh give the start address and Length Cin bytes) of each such 
SECT. Since the number of PSECTs cannot exceed 6 the upper two 
bytes of longword 2 are available for future expansion. 


The DMT is used rice DEBUG initialization to initialize DEBUG's Run- 
Time Symbol yabl e (RST) and Prperes Static Address Table (Program SAT). 
Using the DMT is much faster than he alternative ba. inforas namely 
reading nrough & the entire DST to pick up the nee Hy nformation. The 
information he DAT onvry is enough to build a Module RST Entry for 
each module in the DST and the PSECT information is used to build the 
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Program SAT. The amount of RST symbol table space needed per module is 


not sonpuyeble from the DMT information, but is estimated ~ multiplying 
the DST size of each module by an appropriate scale factor. 


OVERALL STRUCTURE OF THE DST 


The Debug Symbol Table consists of a contiguous sequence of DST records. 
Each DST record contains a two-byte header which gives the length of the 
record in bytes and the type of the record. The structure of the rest 
of the record (if any? is estore ned by the record type. The length of 
the DST in 5i2=byte blocks is given in the image file header; if the DST ° 
does not fill the last block, that block is zero-padded to the end. 


The Largest structural unit within the DST is the module. Each module 
represents the symbol table information of a seperately compiled object 
module. The DST for a module always begins with a Module Begin DST rec- 
ord and ends with a Module End DST record. The Module Begin DST record 
gives the name of the module and the source Language in which it was 
written. The Module End DST record simply marks the end of the module 
and contains no other information. As noted above, if present, the 
penup Module Table (DMT) points to the Module Beara DST record of each 
module represented in the DST. DEBUG uses the DAT (if present) to lo- 
cate all modules in the DST. 


- 


The DST as a whole thus always begins with the Module Begin DST record 
for the first module in the DST. It is followed by the symbol informa- 
tion for that module. Then comes the Module End DST record for that 
module. Immediately after that Module End DST record comes the Module 
Begin DST record for the next module, and so on to the end of the whole 
DST, where the Module End DST record for the last module is found. The 
rest of that image file block is zero-filled to the next block boundary. 
Note that there is no break between modules in the DST. 


NESTING WITHIN THE DST 


For most languages, the symbol table must represent a variety of nesting 
relationships. Routines are nested within modules, data symbols are 
declared within routines, and even routines are nested within rout ines. 
Certain data.constructs, in particular record structures, contain addi- 
eione} nesting relationships. In the Debug syseet Table, such nesting 
relationships are represented by Begin-End pairs of DST records. We 
have already seen above that the largest subunit of the DST, namely the 

ule, is represented by a Module Beg n DST record and a Module End DST 
record bracketting the DST information for the module. 


This principle extends to other nesting relationships. The DST informa- 
tion for a routine is thus represented by a Routine Begin DST record and 
a@ Routine End DST record enclosing the DST information for all syabels 
local to or nepted within that routine. slattarty. lexical blocks (such 
as BEGIN-END blocks or their equivalents in various Languages) are re- 
presented by Block Begin and Block End DST records enclosing the symbol 


. 
. 
. 
. 
. 
. 
. 
. 
. 
o 
. 
o 
. 
. 
. 
. 
. 
. 
. 
* 
. 
. 
. 
. 
. 
- 
. 
o 
. 
. 
. 
. 
. 
a 
. 
. 
. 
. 
. 
° 
. 
os 
. 
° 
. 
os 
. 
. 
. 
eo 
. 
on 
. 
. 
7 
. 
. 
eo 
. 
. 
. 
. 
. 
a 
. 
o 
. 
a 
o 
. 
. 
o 
. 
a 
7 
e 
. 
- 
. 
. 
. 
2 
7 
o 
. 
a 
. 
- 
. 
e 
. 
o 
. 
. 
o 
. 
e 
~ 
6 
. 
e 
. 
os 
. 
7 
. 
7 
. 
. 
. 
e 
. 
* 


1$-se-1944 33:98 e Bese e ke cHR ate Cacsfexosr reo 1 2% «d} 


ST records local to that lexical block. The nesting of routines and 
locks within one another to any depth (within reason) represented by 
the proper nesting of the corresponding Begin and End DST records. 


An example any hetp clarify this notion. The following example shows a 
progres na fictitious language along the corresponding sequence of DST 


Program Structure 


DST Record Sequence 


PUPP 


MODULE M = 
BEGIN 
VAR SYM_M1: INTEGER; 
VAR SYM_M2: REAL; 


ROUTINE R1 = 
BEGIN 


Module Begin M 


Data SYM_M1 (DTYPE_L) 
Data SYM_M2 (DTYPE_F) 


Routine Begin R1 

Data SYM_R11 (BOOLEAN) 
Data SYM_R12 (DTYPE_L) 
Routine End (for R1) 
Routine Begin R2 

Data svn Rg] (DTYPE_D) 
Data SYM_R22 (DTYPE_L) 
Routine Begin R2A 


Data SYM_R2A (DTYPE_B) 


GIN 
VAR SYM_R2A: BYTE; 
BEGT Block Begin (no name) 


VAR BLK_V1: WORD; Data BLK_V1 (DTYPE WwW) 
ROUTINE nesLKR = Routine Begin R2BLRR 
FOO: lock Begin FOO 


BEGIN 8 
VAR FOO_V:REAL; Data FOO_V (DTYPE_F) 
END; Block End (for F006) 


VAR R2BLK_V2:REAL; Data R2BLK_V2 (DTYPE_F) 

END; Routine End (for R2BCKR) 
VAR BLK_V2: DOUBLE; Data BLK_V2 (DTYPE_D) 
END; Block End (for no fame) 


REI OOS NOE UV O09 NO AEWA OSB IF ARVO ODDIE AROS 


END; Routine End (for R2A) | 
VAR SYM_R23: REAL; Data SYM_R23 pores F) 
END; Routine End (for R2y 
END; Module End 
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local routine R2BLKR, local routine R2BLKR contains a data symbol and a 
labelled FFSiN. ND block FOO, and block FOO contains one local symbo 
FOO_.V. ALL this nesting represented by Begin and End DST records in 
the Debug Symbol Table as ill he right. 


Additional nesting must be represented for data. A record (called a 
structure in some languages) is a composite data object containing some 
number of record components of various data types. A record component 
may itself be a record. In addition, some Languages allow records to 
have ‘‘variants’’ (as in PASCAL), which mposes additional structure that 
must be represented in the DST. 


ustrated on 


A record type is represented by a Record Begin and Record End DST record 
pair phe eddy the DST records for the record components. This notion 
is illustrated by this program segment and the corresponding DST: 


DST Record Sequence 


TYPE RECTYP = Record Begin (RECTYP) 
RECORD OF 
COMP1: INTEGER; Data COMP] (DTYPE_L) 
COMP2: AL; Data COMP2 (DTYPE_F) 
COMPS: DOUBLE; Data COMPS (DTYPE_D) 
END; Record End (for RECTYP) 


Here RECTYP is a record type. Each object of this type is a record con- 
taining three components, COMP1, COMP2, and COMPS. is structure is 
represented in the DST a a Record Begin DST record followed by Data DST 
records for the gonpenen s followed a Record End DST record. e 
addresses specified in the component DST records are bit or byte offsets 
from the start of the RECTYP record as a whole. 


In this example, the Record Begin DST record for RECTYP mey in fact re- 
grocers either a record type or a record object. A field in the Record 
egin DST record indicates which. However, let us assume that RECTYP 
defines a record type. How do we then declare objects of that type? 

The following example illustrates how: 


DST Record Sequence 


Program Structure 


Data REC! {Sept ypspec) « 
TYPE RECTYP = Record Begin (RECTYP) 
RECORD OF 
COMP1: INTEGER; Data COMP! (DTYPE_L) 
come: AL; Data COMP2 (DTYPE_F) 
COMPS: DOUBLE; Data COMPS (DTYPE_D) 
END; Record End (for RECTYP) 
VAR REC1: RECTYP; 
VAR REC2: RECTYP; 


Data REC2 (SepTypSpec) 
Type spec DST record 
(Indirect Type Spec 
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pointing to RECTYP) 


RECTYP 
- also deft meets d REC2. y data op ects are represented 
Borers ' pe ies 4 cation DST records. delice a DST record must be 

ned ately followed by a DST r gcord that defines ‘i sym bolts data type. 

he REC1 at Type Speciti cation es? recorg s immedi atel followed 
- the RECTYP Record Begin DST recor qi he nce Sr is ve the RECTYP data 
type. The REC2 seneresy Type Specificat fon dS cecore f S lenediote y 
followed a s Type .§ itt cation DST record 
Ind rect Type spect! tat on thay points ack m 7 Record Begin DST 
record for RECTYP. Hence REC2 is also of that record type. 


Here the none Bs a Fype s defined. Two objects of that aby 
m= 


an object of some a type. A record component of a record type is 

represented the same w “2 other object ef a@ record type. namely by 
eparate Type. Specification ST record. This record mus 

by a Record Begin DST recerg or by a Type Specification DST record that 

points to a Record Begin DST record. record component can also be 

represented bye a Record Begin DST record directly if this record is 

marked as defining an object rather than a type. 


Record yer tents. as found in PASCAL, introduce additional pSteyetyres 4 
qetel tee degcr pt tpn of how variants are represented in the DST is found 
in the section on ‘Record Structure DST Records’ Later A this defini- 
tion file. Here we wait only give an example that illustrates the gene- 
ral scheme that is used 


DST Record Sequence 


Program Structure 


Data REC1 fae eReet pec? 
TYPE RECTYP = Record Begin (RECTYP 


RECORD OF 
COMP1: INTEGE Data COMP1 (DTYPE_L) 
CASE TAG: BCOLEAN OF Data TAG (BOOLEAN 


gin 
(tag variable = TAG) 


FALSE: (¢ Variant Value ver FALSE 
sores REAL; Data COMP2 (DTYPE_F) 
COMPS: DOUBLE); Data COMP (DTYPED _D) 
TRUE: ( Variant Value for TRUE 
COMP4: INTEGER); Data COMP4 (DTYPE_L) 
END CASE; Variant Set End 
END; Record End (for RECTYP) 


“VAR RECI: RECTYP: 


Nesting is also used to describe enumeration types as found in PASCAL 
and sone other Lang guages. An enumeration type escribed by an Enum- 
eration Type Begin ‘OS record followed by Enumeration Type Element DST 


4.0-74 Page 13 
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records for all the enumeration Literals of the type followed by an 


Enumeration Type End DST record. Any actual object 9 the enumeration ; 
ty e must be described by a seperate Type Specificat > DST record. : 
[78 oo e illustrates what the DST for an enumeration type looks ‘ 
Program Structure DST Record Sequence ; 
Data HUE (SepTypSpec) : 
TYPE COLOR = ( Enum Type Begin COLOR 
Enum Type Element RED F 
GREEN, Enum Type Element GREEN |: 
BLUE Enum Type Element BLUE 
); Enum Type End (COLOR) 
“VAR HUE: COLOR; 
VAR PAINT: COLOR; ata PAINT (SepTypSpec) 
ype Spec DST record 


(Indirect Type ppes 
pointing to COLOR) 


A more detailed description is found in the section entitled ‘'Enumera- 
tion Type DST Records’ later in this definition file. 


For some DST record types, DEBUG ignores all nesting relationships below 
the module level. Line Number PC-Correlation DST records, for example, 
Bey be scattered throughout the DST for | module. DEBUG treats all such 
DST records as defining the Line number nformation for the module as a 
whole, regardless of how they may be scattered within or outside the 
routines and blocks of the module. grater ly Source File Correlation 
DST records may be scattered throughout the §1 for a module. Records 
such as these can be generated wherever the compiler finds it most con- 
venient to generate them. 


DATA REPRESENTATION IN THE DST 


Data Symbols are described in the DST by a variety of representations. 
Fundamentally, all push representations give three pieces of information 
about each data symbol: its name, its ress or value, and its data 
type. DEBUG needs additional information about a cote symbol . in parti- 
cular its scope of declaration, but that information is implicit in the 
nesting structure of the DST as described above. 


Rete Be Ge Ge Ge Fe Se Se Ge Se Ge Se Ge Se Se Ge Se Se Ge Se Se Se Ge Se F4 Ss Ge Se Se He 
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The name is given by a Counted ASCII string in the data syabel | DST 
record. The value or eddress gan be given by five-byte encoding con- 
taining one byte of gontrot nformation and a qrevere address, offset, 
or value, However, if this five-byte encoding is not adequate to ¢ 
scr be the address or value, escapes to a more complex value specifica- 
tion later in the DST record are available. The data type may be repre- 
sented by a one-byte type code, but if that is not orequace there are 
several escapes to a more complex type description elsewhere in the DST. 
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71 

71 The ptene rd five-byte value soge ification can specify any 32-bit or 

7 smaller Literal value, | Static byte address, any reg ster oggrets. 

7 and any oceress hat can be formed y one indexing operation off a reg- 
7 jeter or one in rection or both. a VAX Standard Descriptor exists 


or the symbol in user memory, the five-byte encoding can describe the 
descriptor address 1 any of the above means; the actual data address is 
then retrieved from the descriptor. 


The standard five-byte value specification is adequete for the bulk of 
all data symbols. However, there are cases yhen t is inadequate. It 
cannot describe Literal values longer than 32 bits, it cannot describe 
very complex address computations, and it cannot describe bit addresses 
unless an eperoer ate descriptor {s evattaa\e n user memory. For these 
cases, the first byte of the rivenpyee encoding must have one of several 
special escape values. The remaining Longword pose contains (in most 
cases) a pointer to a more complex value specification later in the same 
DST record. That more complex yelue,.s ecification may consist of a VAX 
Standard Descriptor or a ‘'VS-Follows’’ Value Specification. A VS-Follows 
Value Specification can, in the most complex case, contain a routine to 
be executed by DEBUG to compute the desired value or address. This rou- 
tine may even call compiler-generated thunks when the complexity of the 
address computation so requires. 


uw 


The details of these more complex yolug specifications are given in the 
section entitled ‘DST Value Specifications’’ later in this definition 
file. The point being made here is simply that the DST provides a 
simple and compact value specification mechanism that is adequate for 
all simple cases, but it also provides several escapes to arbitrarily 
complex DST Value Specifications. These complex value specifications 
are capable of describing all known address and value computations 
required by the languages supported by DEBUG. 
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Data type specifications are done in a similar wey For all simple, 
atomic data types, a single type byte describes the data type of a data 
symbol. However, there are several escape mechanisms for more complex 
data types. One mechanism is to take the type information from a 
qtendere Descriptor found either in yser memory or in the DST. Another 
s to use a Separate Type Specification DST record for the data symbol, 
The data type is then described by a second DST record which immediately 
follows the Separate Type Specification DST record. This second record 
must be a Record Begin DST record Cgeecr ib ing a record type? an Enume- 
ration Type Begin DST record (describ ng an enumeration ypes, or a Type 
Specification DST record. A type Specification DST record can descr e 
any data type supported by DEBUG. It contains a DST Type Specif 
for the data type n question. This Type Specification may be an Indi- 
rect Type Specification, pointing to ST record elsewhere in the DST 
that def nes the data type. Alternatively, it may describe the desired 
data type directly and may be as complex as the data type requires. 
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DST Type Specifications are described in a separation section elsewhere 
in this definition file. |The point being made here is mply that the 


simple one-byte type specification is available for simp 
but several escapes to arbitrarily Gonpies DST type spec 
available when the simple type spec 


e data types, 
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FIELD ACCESS MACROS 


The following macros are used in srt ining BLISS field names for all data 

syructures in the Debug Symbol Table. T “ye macros supply the position, 

size, and sign-extension values when used in FIELD declarat ons for 

BLOCK and BLOCKVECTOR data structures. They are used instead of their 

numeric equivalents because they are clearer and less error-prone. The 

yor ous generic forms (as specified by the letters in the names) are as 
wS: 


A Materialized address 

L Longwor 

Wd Zero-extended word 

8 Zero-extende pyte 

V Zero-extended bit field 
SW Sign-extended word 

$B Sign-extended pyte 

SV Sign-extended bit field 


The ‘‘A’’ form should be used whenever the field being defined is such 
that only the address of the field may be materialized in a structure 
reference; that is, fetch and store operations on the field are not 
valid. An example of such a field is an ASCII string. 


Each of the ‘'V'’ and ‘’SV"' forms take one or two parameters. The first 
parameter is the bit gos ts ton within the venquere or byte and the 
second is the field size in bits. The secon pereneser is optignal: 
f omitted, it defaults to 1. Thus V_(5) means bit 5 while V_(5,3) 
means the $-bit field starting at bit 5 and ending at bit 7. Bit 
ositions are counted from the low-order (least significant) end of the 
ongword, starting at zero. 


This following field access macros are used in DSTRECRDS.REQ. Their 
actual definitions are found in STRUCDEF.REQ, but are shown here for 
the convenience of the reader. 


MACRO 
AL = 0, g. * ! Address of a field 
.- = Q, 32, i, ' Longword 
We = Q, 16, i, ! Word, zero-extended 
B_ »e §, 8, z } ? te, zero-extended 
VI(P,S) = P, RIF XNULL(S) ZTHEN i SES FI. 9 %, ! Unsigned 
. @ 
SW es 6, 4M. 1 1. ! Word, sign-extended 


SB~ .o, 2, U8 i Byte s ign-extended 
SV7(P,S)= P, RIF BNULL(S) ZTHEN 1 ZELSE : tl. 1%, ! Signed 
' bit field 


Bring in the field access macro definitions from STRUCDEF.L32. 
IBRARY *LIBS$:STRUCDEF .L32'; 
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THE DST RECORDB HEADER FORMAT 
ALL DST records have the same general format, consisting of a fixed 


two-byte header followed by zero or more fields whose format is 
determined by the DST record's type. This is the format of all DST 


records: 
Seeweeeeeeeeeeeeeeeeeeeoeeeecceseeceseeseeeceseesesececcesecoes + 
byte H . DSTSB_LENGTH H 
byte } ; DSTSB_TYPE H 
vari DSTSA_NEXT 
Zero or more additional fields depending on 
the value of the DSTSB_TYPE field 
§onensenceqsneessenngencowncenmsrennensranrnseneenssennenenens + 


These fields appear in all DST records. 
IELD DSTSHEADER_FIELDS = 


Ne ee ee a oe ee EEE EEE EEE EES 


DSTS$B_LENGTH ={0, 6.1], ! The Length of this DST record, not 
: including this length byte 

DSTSB_TYPE = f ', &. }- ! The type of this DST record 

DSTSA_NEXT =(€1, AL ! The next DST record starts at this 
: location plus DST$B_LENGTH 


- TES; 
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SUPPORTED VALUES FOR DSTSB_TYPE 


aye supported values of the DST record type field (DST$B_TYPE) are 
Listed here. If the yalye is in the range of DSCSK_DTYPE_LOWEST to 
DSCSK_DTYPE_HIGHEST, it is a VAX Standar Typ¢ Codeand gives the 
data fEype of the object being defined, In s case, the record is 

a Standard Data DST Record or one of its variants. Otherwise, the 
type value must be in the range DSTSK_LOWEST to DSTSK_HIGHEST or it 
may be DSTSK_BLI. In these cases, the type code denotes the type of 
the DST record and the format of the record is determined by type 
value. ALl other type codes are unsupported by DEBUG. The type codes 
between DSCSK_DTYPE_HIGHEST and DSTSK_LOWEST ars roasrves for future 
use by Digital. The type codes in the reoge 192 = 255 

reserved for use by customers, although DEBUG 
= type codes. DE 
co 


are potentially 
does not support any 
BUG ignores all records with unsupported type 


VAX STANDARD TYPE CODES 


As mentioned above, VAX Standard’ Type Codes can be used as DST record 
cype codes for data symbols. The type code then gives the data type 
of the symbol in addition to indicating that the DST record has the 
Standard Data DST record format or a variant thereof. 


ALL VAX Standard Type Codes are Listed here for convenience. They are 
commented out since they are actually declared in STARLET.REQ. 
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! DSC$K_DTYPE_7 = 0, ! Unspecified (May not appear in DST). 
! DSCSK_DTYPE_V = 1, ! Bit. . 

! DSCSK_DTYPE_BU = ¢° ! Byte logical. 

! DSCSK_DTYPE_WU = 3, ' Word logical. 

! DSCSK_DTYPE_LU = 4, ' Longword logical. 

} Tho el ile = 5, ' Quadword logical. 

: D Cox DT vee .8 = . Byte integer. 

i DSESK-DTYPENL = 8: i ton a nteger. 

i DSCS$K“DTYPE— = 5° i Quadword integer. 

! DSCSK_DTYPE_F = 16, ! Single~precis on floating. 

; $43 oh Uhl SF = : . Bou te=precision floating. 

! = 12, ! Complex. 

! DSCSK_DTYPE-DC = 18° : Double-precisi n Complex. 

i DSCSK-DTYPE-T = 14, | ASCII text string. 

! DSCSK_DTYPE_NU = 15, ! Numeric string, unsigned. 

! DSCSK_DTYPE_NL - = 18. ! Numeric string, left separate sign. 
! DSCSK_DTYPE_NLO = 17, |! Numeric string, cots overpunched sign. 
! DSCSK_DTYPE_NR = 1. ! Numeric string, right separate sign 
i DSC$K"DTYPE—NRO = 19; | Numeric string, right overpunched sign 
! DSCSK_DTYPE_NZ = ste ' Numeric string. zoned sign. 

! DSCSK_DTYPE_P = 21, ! Packed decimal string. 
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; 9 ' DSCSK_DTYPE_71 = 22. ! Sequence of instructions. : 
; 9 : ; DScSK-DIVPE MTN = is: ; Proce ure entry mask. : 
; i 2 ; DSCSK_DTYPE_DSC = 24, + Descr ror used for arrays of 3 
; : : namic strings $ 
; 9 ! $43 8 dae Sh om, 4 Octeusta ) ical ; 
: 9 : $45 1 Uh 0 = g. ! Octaword nteger : 
; 9 ! DSCSK_DTYPE_G = 27,  ! Double prec gn G float ing. a ; 
; 9 ! DSCSK_DTYPE_H = 8. ' Quadruple precision poet tae ‘bit 3 
: 09 i DSCS$K“DTYPE-GC = 29, | Double precision complex, G fl Lost ng ; 
3 931 ! DSCSK_DTYPE_HC = 30, ! Quadruple precision Searles: H ttoe ing ; 
3 9 § ! DSCSK_DTYPE_CIT = 31, ! COBOL intermediate temporary : 
; 9 ! DSCSK_DTYPE_BPV = ¢° ! Bound Procedure Value 3 
3 9 ! DSCSK_DTYPE_BLV = 35,  ! Bound Label Value : 
; 34 5 ! DSCSK_DTYPE_VU = 34, ! Bit Unaligned : 
; 9 ! DSCSK_DTYPE_ADT = 35, ! Absolute Date-Time 3 
; 0 ! = g. ' Unused (not supported by DEBUG) 3 
; 09 8 ! DSCSK_DTYPE_VT = 37, ! Varying Text : 
i 0948 i 
> «=60941 ! The next two values are used for range checking of the type values : 
; 8 4 in DST entries. They are used mainly in CASE statements. 3 
: 0944 0 DSC$K_DTYPE_LOWEST = 1 ! Lowest DTYPE data type we support ; 
; Bete 8 DSCSK_DTYPE_HIGHEST = 37; ! Highest DTYPE data tyoe we support ; 
:  Ooea 0 
; 0949 0 } INTERNAL TYPE CODES FOR DEBUG 

; 0950 ! 

ie 

3 934 ! The following Get inittons are used internally in DEBUG, but are not 

; 0954 0 : supported in the DST. They should be deleted here if they are made 

; 0955 0 ' into standard VAX type codes declared in STARLET.REQ. These numbers 

3 B928 8 ! may change from one release of DEBUG to the next because they must 

3 4444 always be larger than DSCS$K _DIVPE HIGHEST. 

: 0959 0 i 

§ 44 Define DEBUG-internal type codes. 

; 306 0 LITERAL 

> 096 DSC$K_DTYPE_AC = 38. ! ASCIC Text 

3 DSCSK_DTYPE_AZ = 39, ! ASCIZ Text 

; 965 DSCS$K_DTYPE_TF = 40, ! Boolean True/False ( ength in bits) 

H aes 443 fl i SY 2 oe signed bit-field (al gned 

; DSC$K_DTYPE_SVU = 4g: ! Signed pits field (una toned 

; 0968 DSCSK_DTYPE_FIXED = 45, ! Fixed b fat: used for FIXED in ADA 

i 0969 i and F ED BINARY in PL/I. This 

3 970 : code A. the type conversion 

; 44 ! febles” io DBGEVALO 

: 097 

3 974 ! The following Literals are used as CASE statement bounds internally 

3 af? in DEBUG for the range of DTYPE codes used. 

: “4 DBGSK _MINIMUM_ pIvee = 0 ' Lowest internal DEBUG dtype value 

: 0978 DBG$K_~MAXIMUM_DTYPE = 4$; | Highest internal DEBUG dtype value 


6 
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; 79 3 
3 980 3 
3 331 ! The following definition is only used internally in DEBUG. It is : 
$ 9 ¢ ! a DTYPE code that is tengorartty put into a Value Descriptor to : 
3 9 ' tell the aceress expression interpreter that the Value Descriptor ; 
; 9 ' came from a | fer lL constant. It does not have to be in the above : 
3 985 ! range because it is only used during the parsing of address expres- : 
: an9 ' sions. After the address expression has been parses, if the DIYPE : 
; 94-44 is LITERAL, it is then changed to DSCSK_DTYPE_L. ; 
; 989 LITERAL 3 
; Bay DSCSK_DTYPE_LITERAL = 191; ! Value is from a Literal constant : 
3 99 3 
:  bo9g OTHER DST TYPE CODES 
3 Baez : 
3 $999 ! The Het outing literals are the DST type codes other than VAX Standard : 
; 0998 ! Type Codes which can appear in DSTSB_TYPE. Each indicates the format 3 
; 0999 0 ! of the record which contains it and most indicate the kind of object : 
; 1000 0 : being described by that record. When new DST records are defined, the : 
; 1001 O : type code is assigned by making DSTSK_LOWEST one smaller and using that ; 
3 1006 8 ! value. The type codes shove TSK_HIGHEST (191) are reserved, the idea : 
; 100 : penne that the DTYPEs 192 - 255 are architecturally reserved to users. 3 
; 1006 0 : DEBUG ignores all DST records whose type codes are not DSTSK_BLI, in : 
; 1005 8 ' the ronge from DSCS$K_DTYPE LOWEST to DSCSK_DTYPE_HIGHEST, or in the 3 
3 1007 range DST$K_LOWEST TO DSTSR_HIGHEST. : 
oo : 
s; 1010 ! Define all Additional Debug Symbol Table record type codes. Note that the 3 
; 1011 ! BLISS Special Cases record has code zero (for historical reasons). LL : 
3 ig ; other type codes are in the range DST$K_LOWEST to DSTSK_HIGHEST. : 
; «©1014 LITERAL 3 
3 HF DSTSK_BLI = 0, } BLISS Special Cases Record : 
; 1017 DSTSK_LOWEST = 153, ! Lowest numbered DST record in this : 
; 1018 } Fonge~~veed for range checking : 
; ©1019 DSTSK_VERSION = 153, ' Version Number segord : 
; 1020 DSTSK_COBOLGBL = 154, ' COBOL Global Attr oute Record 3 
s 1021 DST$K_SOURCE = 155, ; source File Correlation Record : 
3 18 2 DSTSK_STATLINK = 12. ' Static Link Record F 
; ©1025 DST$K_VARVAL = 157, ! Variant Value Record : 
; 61024 | DST$K_BOOL = 158, ' Atomic object of type BOOLEAN, 3 
; 1025 ! Allocated one byte. 3 
eee § ! low order bit = 5 if TRUE : 
ye " ! low order bit = 0 if FALSE. : 
; 18 3 DSTSK_EXTRNXT = 159, ' External-Is-Next Record (Obsolete) : 
7.3 DSTSK_GLOBNXT = 160. ' Global-Is-Next record (Obsolete) : 
; 1030 DSCSK_DTYPE_UBS = 161, ! DEBUG jnternel use only (unaligned ; 
s 403) : bit string) (Obsolete) : 
ie § DS TSK _PROL 0 = 1 ¢ ' Prolog Record ° 3 
ee DSTSK_SEPTYP = 163, ' Separate Type Specification Record 3 
> DSTSK_ENUMELT = 164, ! Enumerated Type Element Record : 
: 1035 DSTSK_ENUMBEG = 165, ! Enumerated Type Begin Record ; 


6 
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3 18 DSTSK_ENUMEND = 166. ! Enumerated Type End Record ; 
cas DSTSK_VARBEG = 1 . ! Variant Set Begin Record : 
; 10 8 DSTSK-VAREND = 1 8. ! Variant Set End Record : 
3; 10 DSTSK_OVERLOAD = 18 ‘ : overloaded Syabol record : 
; 1309 DSTSK_DEF_LNUM = 170, ! Definition Line Number Record : 
> ©1041 DSTSK_RECBEG = 171, ' Record Begin Record ; 
: 1049 DSTSK-RECEND = 172, i Record End Record 
3 130 DSTSK_CONTIN = 175, ! Continuation Record : 
> «= 1044 DSTSK_VALSPEC = 174, ' Value speg i tice ion Record : 
; 1045 DSTSK_TYPSPEC = 175, ! type Specification Record ; 
; 1068 DSTSK_BLKBEG == 176. ' Block Begin Record : 
; Ise DSTSK_BLKEND) == \f ° ' Block End Record : 
> 1048 DSTSK_COB_HACK = 178, ! COBOL Hack Record (Obsolete) ; 
; 1049 : = 179, ! Reserved to DEBUG ; 
: 1929 : = 190. ! Reserved to DEBUG : 
3 103) DSTSK_ENTRY = 18) ! Entry Point Record : 
3 1026 DSTSK_LINE_NUM_REL Rif ! Threaded Code PC-Correlation : 
: 105 =f ¢° ! Record (Obsolete) ; 
; ©1054 DSTSK_BLIFLD = 183, ! BLISS Field Record : 
; ©1055 DSTSK_PSECT = 184, ! PSECT Record . 
; 1328 DSTSK_LINE_NUM = 185, ! Line Number PC-Correlation Record ; 
: ©6105 DSTSK-LBLORLIT = 1 g. ! Label-or-Literal Record 3 
; 1058 DSTSK_LABEL = 187, ' Label Record ; 
: 1059 DSTSK_MODBEG = 188, ! Module Begin Record : 
; 1060 DSTSK_MODEND = 189, ! Module End Record : 
; 1061 DSTSK_RTNBEG = 190, ' Routine Begin Record : 
3 1306 8 DSTSK_RTNEND = 191, ! Routine End Record 

3 106 DSTSK_HIGHEST = 191; ! Highest numbered DST record in this 

3 vg: 0 ! range--used for range checking 

; 1906 o NOTE TO DEVELOPERS: 

; 1068 QO ! New DST Records should not be added at this end of the DST record number 

3 198? 0 ' range. VAX Standard Type Codes 192 - 255 are reserved to users. Hence 

; 1070 0 ! DEBUG does not use type codes in that range, even though DEBUG does not 

: ©1071 3 ! support user-defined t pe codes. New DST record numbers should be allocated 

30 6 72 ! by decrementing DSTSK.L WEST and using that number for the new DST record. 
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MODULE DST RECORDS 


The Debug ri ol Table for each separately compiled pom must be 
ancl pees with o. a meee eos n/Module-End pair of DST records. The 
dule Begin DST record must thus be the ver ret pst” record for 

any y poperstely comp zee module ( 1s8z¢ any ob ett le) and the Module 

End record must be the very last DST record for the prepie. Only 

one went y-oe hayes SF pair is allowed in what the Linker sees 

as a single object module. (If multi ie erty e-peetn/Remulecene pairs 

oy included in one object -module, DE ve only see th ti rst such 
r and ignore the rest because the | male will only tell DEBUG about 

er Location of the first Module Begin record.) 


The mad y) o~Seg tn Mady) onare pair defines a syqbol te scene which con- 
tains all symbols defined by DST records within that pete r. The module 
has the name given in the Module Begin DST record. The language of the 
object module is also encoded in the Module Begin record. 
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THE MODULE BEGIN DST RECORD 


The Module Begin : Record marks the beginning of the DST for a module. 
This DST record a ives the name of the module and the source lan- 
guage in “ ch the: a0 ule was written. The Module Begin DST Record 

must be the the first DST record ‘2 enyery comp cas ten unit (‘module’) 
and it must be matched by a Modul ¢f T Record that ends the DST for 
that module. Only one Module Begin ST wecers is allowed to appear in 
the DST for a separately compiled object module. 


This is the format of the Module Begin DST Record: 


Seed: aT deeaceaneereriioe comimieiameies suneninens 
bye OO PETE, i None Bid he! mae = 2 eee iene 
i byte | _DSTSB_MODBEG_UNUSED 
Sa RE wenenensDSTSL_AODBEG.LANGUAGE } 
Det = eatnstenainen athe ta se POET SRN ; 
Set The Module Name in ASCII | 

(The name's Length is given by DSTSB_MODBEG_NAME) 

Ss CR SS Re se Se et al ee a 


i Define the fields and size of the Module Begin DST Record. 
FIELD 9 ape FIELDS = 


ST$B8_MODBEG_UNUSED = f . B 
DSTSL~ “MODBEG-LANGUAGE = el 


‘ 
' 
' 
' 
' 
' 
| 
' 
' 
' 
! 
' 
' 
' 
' 
J 
t 
' 
' 
' 
! tere o camo Te ete ee ere emer een ee eos eeeseseeecesesescecco See neo ae wwe + 
' 
' 
' 
' 
! 
' 
' 
' 
' 
' 
i] 
' 
' 
' 
' 
' 
F 


Unused--Must Be Zero 
Langue a cede of language in 
h module was written 


DST$B_MODBEG_NAME =(€7, BL] Count byte in none counted 
string 
TES; 
LITERAL 
DSTS$K_MODBEG_SIZE = 8; ! Size in bytes of the fixed part of 
i the Module Begin DST record 


! Define all the Language codes that may oper } in the DSTSL_MODBEG_LANGUAGE 
i field of the Module Begin DST record. (Note t apt DEBUG may not actually 
1 support all languages that have Language codes.) 


LITERAL 
DSTSK_MIN_LANGUAGE = 0, ! Smallest Language code 
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& DSTSK_MACRO = 0, ! Macro 
DeTSecBLiss = 2. i plisse 
- = oe . $s 
DST =C680t = §; i Cobol 
DST -BA I = 4, ' Basic 
DSTSK_PL = 5, ' PL/I 
DSTSK_PASCAL = 6, ! Pascal 
$ DSTSK_C = /, i¢ 
DSTSK_RPG = 8, ' RPG 
BS Tsk ADA s ' ada 
DSTSK_UNKNOWN = 16, ! Language Unknown 
DSTSK_MAX_LANGUAGE = 10; ! Largest language code 
6 
8g ' Here ates, ’ Rag bbe > i the same Language ¢ ysing names with the DBGS$ 
64 ' prefix. prefix is used in DEBUG for h ster Yeal reasons. These names 
65 may ir, thle bre be discarded. 
§$ LITERAL 
68 DBGSK_MIN_LANGUAGE = DSTSK_MIN_ LANGUAGE, ! Smallest Language code 
$9 DBGS$K_MACRO = DST$K_MATRO acro 
9 DBGSK“FORTRAN = DSTS$K~ FORTRAN, Fortran 
7 G$K_BLIS3 = DSTSK-BLISS, ! Bliss-32 
if; BGS$K_ COBOL = DSTSK_COBOL, ! Cobol 
7 DBGSK_BASIC = DSTSK“BASIC. ' Basic 
7 DBGSK_PLI = DSTSK_PLI ' PL/I 
7, DBGSK-PASCAL = DSTSK~PASCAL, | Pascal 
¥§ DBGSK_ = DST$SK_C ! 
7 DBGS$K RPG = DSTSK"RPG, =i RPG 
8 DBGS$K_ADA = DSTSK_ADA — ; A 
7 DBGSK_UNKNOWN = DSTS$K~ SR RAKY anguage Unknown 
DBGSK_MAX_LANGUAGE = DSTSK_MAX NCANGUARE ! Largest Venquage code 


Language UNKNOWN requires some special quplenation, benus supports ‘‘unknown"’ 
Lan uages with a standard set of DEBUG functionality. s standard set in- 
cl LL Language-independent functional ty piue Mani llantt pis everes” Language 
quaress ons. Identifiers are assumed to allow A - Symbol 
references may include pudscr ips ing (using roun 0 or square *,° pardatheses! 
and record component ont os on (using dot=notation as in A.B.C). Most simple 
operators are allowed anguage expressions. 


While not officially supported, Longue H Benn is intended as an escape for 
cone! hore wates do not RR. ha oye & ei HP By specifying language 
od NOWN i TSL _pobBEG TANGUA f eld - such Languages can 
take cannes of ynatever. ; port DEBD © prev crs or unknown languages. If 
re when true DE ; provided. 8 new Language code for the new 
ncrementing DSTSK_MA NGUAGE by one and as- 


l at ed Hs 
sfoayage ie t.3 oca > to the new Language.” 


gning that language code 


treats any out-of-range lan e code in ghe ule Be ST record as 
pe ng equ valent to Language UNKNOWN’. U Use of ele Me Vangutge code 
or ony. outs “range language code is intended ernal use b 


ont nown-langu support not offi cially suppor oC and s 
7 OR to ye A oe incompat ibte changes tn luture releases DEBUG 


Internally, DEBUG treats the language code as a byte value. Hence any lan- 
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1206 0 ! guage code above 255 is truncated to its low-order eight bits. 
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THE MODULE END DST RECORD 


The Rody e End DST Record must be the Last DST record in the DST for a 
compilation unit. Its sole purpose is to mark the end of the DST for 
a@ separately compiled object module. There can be only one Module End 
DST recere ber module, matching the previous Module Begin DST record. 
This is its format: 


ee a > Tew wer smn emo seman womwr eww asc cenwaone + 


byte i DSTSB_LENGTH (= 1) ' 


te wer er ce me em ee ee em eon ee eee ese net ee mee wes crete ewe seem wee eo eo reson} 


byte } DSTSB_TYPE (= DSTSK_MODEND) to _3 


Pee eee OOOO SSCS S HOS SSSS FO SSESSESESEEEEEESTOEOEOS eeeceoe ww eer mre nae een ee + 


Define the size in bytes of the Module End DST Record. 
ITERAL 


' 
' 
L 


ee ta i a Ss 2s 2 ss SS + Ss Ls 1s ss os SS 


RroNoPoRonononon | 3 SS Se Se 


ONO VEUN —-OOONOUS 


DSTSK_MODEND_SIZE = 2; | Size of Module End record in bytes 
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ROUTINE DST RECORDS 


- * A routine is represented in the Debug Symbol Jepte by a petr f DST 
records, eeneny a Routine Begin ie record which is matched with a 
peter Routine End DST record. ALL DST records between the Routine 

Begin and the Routine End DST records represent the symbols that are 

Src Cored in that routine or in nested routines or blocks. Nested rou- 

nes are represented in the DST by nested Routin eee in/ Rous inewEnd 
airs. Lexical blocks (BEGIN-END oree or the | ke gqpene ng 

the anquage? may also be nested freely oun de or inside routines, 

provided all blocks and routines are properly nested. 


Nn 


Dt et a et 


Consider the following example of nested blocks and routines. If 
routine R1 contains a nested routine R2 and a lexical block 81 and 
if block B1 contains routine R3 and Block 82, the DST would have thé 
following sequence of DST records: 


Module Begin for whole module 
-»-module-level data DST records... 
Routine Begin for R 

-»- local data DST records for R1... 
Routine Begin for 

»»- local data DST records for R2... 
Routine End for R 
Block Begin for B 

-»- local data DST fycords for Bl... 

Routine Begin for R 

-+- local core 4 T records for R3... 
or 


Block Begin for B 
«+s local date Ost records for B62... 


l 
Block End for 61 
Routine End for R1 
Module End for whole module 


In addition to defining a symbol scope, the Routine-Begin/Routine-End 
air defines the name and address range of the gerrecpyndio routine. 
he name and start address is found in the Routine Begin DST record 

and the byte length of the routine is found in the Routine End DST 

record. It is assumed that the start address "9 also the entry point 
n 
l 
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PADRE UII 


Se Uee 


to the routine. The Routine Begin record also cee whether the 
nkage. 


a ae ec ee ee ee ee a ke ed ed od ed od od = od 


OOO OOOO OOO OOO EEO DODO O DE DOD SSO DODO SO OSE Se Se SeSesesrsesosesoe 


Sa ee i 
Lar—o 


u 
routine uses a CALLS/CALLG linkage or a JSB/BSB 


ee | 


WO OONOUS 


wi 


' 

' 

' 

' 

' 

! 

' 

' 

' 

1 

t 

' 

' 

' 

' 

: 

byte 
byte 
: byte 
Long 
byte 
: var 
‘ 
! 
i] 
a 
1 
i 
! 
' 
' 
' 
] 
F 


LITERAL 
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THE ROUTINE BEGIN DST RECORD 


The Rous tne Begin DST record marks the ee inning of a routine and the 
associated s ope. This record gentarne ¢ routine’s name and start 
address and indicates whether the routine is a CALLS/CALLG royt ne 

or a JSB/BSB routine. It ques a matched of” a = ne End DST record 
Later in the DST, except it the language of the current module is 
MACRO. (Since MACRO routines have entry points but no well defined 
end points, the Sous ng End record can and must be omitted for this 
language. This exception applies to no other Language.) 


This is the format of the Routine Begin DST record: 


pesese seernreere Seeeeoeenoneaeo SSeS See eK BE ORME EEE Teo eee ome + 


i DST$B_LENGTH i 


¢ eer eee mas mecccuwwe eseeeee sueseeeuseeoeveueneces eeecoeeeaoe amare easeanae} 


' DSTSB_TYPE (= DSTSK_RTNBEG) ' 


c= seeeeeoeeoe Seeeeeeeneenee seocecesscoeowwososesosecooscesose}oceccos$ 


i DSTSV_RTNBEG_UNUSED iNO_CALL: 


H DSTSL_RTNBEG_ADDRESS H 


Gueeeweweooewsecussoeeeeseesoncosesseseceso eSeeeoeeaeneaeae Se eeoeoeneoeoeoe + 


i DSTSB_RTNBEG_NAME i 


The Routine Name in ASCII 
(The name's length is given by DSTS$B_RTNBEG_NAME) 


@ coscccccccce 


i Define the fields and size of the Rout ine Begin DST record. 
FIELD DSTSRTNBEG_ FIELDS = 

DSTSV_RTNBEG_UNUSED = e V.(0. 7) 2. 

ES: yeas 43 3 


Unused--Must Be 
This bit is set ‘ rei rou- 
tine is invoked with a 
an er 18 rather a CALLS 
nstruction 


DSTS$V-RTNBEG_NO_CALL = 


DSTSL_RTNBEG_ADDRESS = ( 3, L_ 1], The rout — ;: start address 
entry point address 
DST$B_RTNBEG_NAME et 7, 8 2 The count byte of the rou- 
tine's Counted ASCII name 
TES; 
DSTSK_RTNBEG_SIZE = 8; » j Gyte size of the fixed part of the 


Routine Begin DST record 
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THE ROUTINE END DST RECORD 


The Routine End DST Record marks the end * a@ routine'’s scope in the 
DST. lso contains the arse Length of the routine's code. (Note 
tte teq for Language MACRO but. 


that Routine End DST records must be og 
is the format of the 


are eoeeery for all ner Languages.) 
Routine End DST record: 


$anececcneseeneeeeseneusueescounwsecceceee eeeoeeoe See eee eeeeeneaeaaneae + 


i byte i DSTSB_LENGTH (= 6) ! 
' teem nme ence ene e enn e reese ewe w ee eee ne esenenene woe ee woe eeceseeeee + 
! byte H Unused (Must Be Zero) ! 
i tong i DSTSL _RTNEND_ =S1ZE i 
i Define the fields of the Routine End DST record. 


' 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
byte } DSTSB_TYPE (= DSTSK_RTNEND) ' 
i 
i 
i 
i 
i 
i 
i 
i 
i 
F 


FIELD DSTSRTNEND_FIELDS = 
DSTSL_ATNEND_SIZE = (3, Ll. 1 ! The Length of the routine in bytes 
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LEXICAL BLOCK DST RECORDS 


ukexicat Block’ is ie progr gnaing SH pee es construct other than a 

rout ye AS, that er rave tcOPe, ¥ within whic synbor s con. ge My 
What disti ngu shes from a ‘‘routine’ rom D te A 

view, is that a bl ck 4 a\ueye qntored by ump ng - 6 Pr ie 

falling into it while a routine $ yrS entered by a call net rde~ 

tion of some sort. A routine has a ott oint that can be ed; 

a block does 4 Hence BEGIN-END ocks n BLISS ang PL/I a locks 

and so are Paragraphs and Sections in COBOL. Subroutines, functions, 

and procedures, on the other hand, are peck anten . 


Blocks gre re routings © have one thing in common, however. Both define 
syntactic units within which other syabols can be defined. The Ap 
pose of representing blocks in the to define the scopes ie 
pee» and to give the address ranges of the corresponding bod 

of code. 


A lexical block is eyprecsntes in the Debug Symbol Table by a 

of DST records, namely a Block B Begin? DST record which is matched pe 
a later Block k End DST record. T records portvoes the Block Begin 

aad the pte k Fe. + | rescore represent aed symbols that are declare 

in that: lexical block or in nested routines or blocks. Nested blocks 

are represented in the ost by properly nested Block-Begin/Block-End 

pairs. Routines and blocks may freely be nested within one another, 

usi ng the appropriate proper nesting of the corresponding Begin and 

End DST records. 


The start address of a block's code is given in the Block Begin DST 
record and the byte on th of that code is given in the Block End 

DST record. The name the block is given in the Block-Begin cpcere. 
If a block has no name Otwhich is. Ae for BEGIN-END blocks) 

null name is piven (the name of Length zero). Blocks with mall names 
cannot be explicitly referenced in DEBUG, but Line numbers within such 
blocks can be used to specify breakpoint locations or symbol scopes. 
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byte 
byte 
byte 
Long 
byte 
var 


THE BLOCK BEGIN DST RECORD 


cal block and 


The Block Begin DST Record marks the beginnin 
name and start 


This record contains the block 
It must be matched by a Block End DST record later in the 
This is the format of the Block Begin DST record: 


the associated scope. 


$ ose eas sewer ewre@ OD SS DS Dw GS oe ae ew ae Se an am oe os oS om mm > GH Ge oe ae > oP ae 


DSTSB_TYPE (= DSTSK_BLKBEG) 


ee eee ae 


DST$B_BLKBEG_NAME 


The Block's Name in ASCII 
(The name's Length is given by DSTSB_BLKBEG_NAME) 


Define the fields of the Block Begin DST record. 
IELD OSTSPLESES FIELDS = 


DST$B_BLKBEG_UNUSED 
DST$L_BLKBEG_ADDRES 
DST$B_BLKBEG_NAME 


nused--Must Be Zero 

he block's start address 
byte of the block's 
Counted ASCII name 


= 
Wr 


a kh ak td 
Dh te ek ek eek a tal ala tal al ae tat a ek ee et et 


PUPA E £* EE 
NOUS WN ("OO ONOUS Win 0O0 


GOOCCCOCOOOOCOCOOOOOOOOOOOOOO 
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THE BLOCK END DST RECORD 


The Block End DST Record marks the end of a lexical bloc k's scope in 
the DST. It also contains the prte Length of the block’ s code. This 


is the format of the Block End DST record 
! lashes ate aaah aietatatatetatatabetatatanatatatatatatatatataatetataeteteemaaeh 
Drage FATE iD ae Lindh nth PA OE RIT. 
' byte |} DSTSB_TYPE (= DSTSK_BLKEND) H 
Doped RS OK eas aoe 
any fig aOR seniors Ms Sb anes on ROSE himasaiiana ; 


i Define the fields of the Block End DST record. 
FIELD DSTSBLKEND_FIELDS = 
72 {SL MLKEND SIZE =(€3, Ll. J ! The byte Length of the lexical block 


' 
‘ 
' 
' 
' 
' 
' 
' 
! 
' 
' 
! 
! $¢eeneoena een nanoees eeeeoe saesusceeceucesoes eeeeoeoeeoe wena nna wae een oam a $ 
' 
' 
' 
] 
' 
' 
' 
' 
' 
F 
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DATA.SYMBOL DST RECORDS 


Data symbols are represented in the Debug typtet Table by data DST 
records which come in several varieties. All such DST records give 
three pieces of information about each symbol: the data type of the 
symbol. the value or address or the symbol, and the name of the 

y ° 


The Standard Data DST record is the simplest form of data DST symbol 
record and is used for most ordinary atomic data objects. It repre- 
sents the data type by a one=byte VAX Standard Type Code. It repre- 
sents the value or address of the symbol by a simple five-byte encoding 
capable of specifying 32-bit Literal values, absolute addresses, reg- 
ister locations, and addresses computed as offsets from a register. 
possibly including indirection. It is also possible to specify that 
the computed address is the address of a VAX Standard Descriptor fer 
the data symbol. Finally, the name is represented as a Counted ASCII 
character string. 


There are several reasons why a Standard Data DST record may not be 
adequate to represent a data symbol. First, the eymeet data type 
may be too complicated to represent by a one-byte type code. In this 
case, one of several available escape mechanisms must be used so that 
expanded type information can be included in the symbol's DST informa- 
tion. Second, if the symbol is a literal (a named constant), its 
value may be too Large to fit in one longword. In this case, an ex- 
panded value specification must be used. And third, if the symbol is 
a variable, its address may be specified by a more complicated compu- 
tation than can be represented in the Standard Data DST record. In 
sate ia an escape to a more complicated value specification must 

e used. 


et tet PPR RPA A Se RY 
WR — OC VONOUES WN" OVOONOULS WN —O”0@ 


Expanded type specifications come in three main forms: Descriptor 
Format DST records, Separate Type Specification DST records, and 
various specialized DST records that handle various special kinds 
of data types such as record structures, enumeration types, and 
BLISS structures. 


Boser'ipter Format DST records are used when the data object must be 
described by a VAX Standard Descriptor and has a static address. 

packed decimal data object. for example, must be described by a 

descriptor that speci! es the object's length and scale factor. If 

a descriptor exists in user memory at run-time, the Standard Data 

DST record can be used, but otherwise it is necessary to include the 

descriptor directly in the DST within a Descriptor Format DST record. ’ 
These DST records are used for all static arrays and other data objects 

that can be described by VAX Standard Descriptors. 


SPBVLSSELES 


SELESRANLSSSLEARAN= 
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oo 


For data types that can be described by neither ones byte type codes 
nor VAX Standard bescriptors, a Separate Type Specification DST record 
must be used. In this case the DST record's type field indicates that 
the type specification is found is a separate DST record which imme- 

y follows the present DST record. The DST record that follow 
must be a Type Specification, Record Begin, or Enumeration Type Begin 
DST record. These records can describe all data types supported by 


a ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee eee 
Pw ee eee eae eee eee sat a et er er et et ee ee ak et et aed ae ae et et et Oe et et te ee ee 
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; } 1) H DEBUG in full detail. 

eb i$ ! As mentioned above, the third data type ‘escape’ mechanism is to use 

ns 18 ! one of , number of apes jel ized DST records that describe data symbols 

aan ! of pes al kinds. BLISS structures and fields, for example, are de- 

: 1520 ! scribed by special DST records, as are erunerest nt ge elements. 

; 1521 ! These DST records will not be further described in this sect on; they 

3 } ¢ } are described elsewhere in this definition file. 

s 1526 ! Expanded ‘Value Specifications’’ must be used for data symbols whose 

3 Wee ! values or addresses are too long or too compl cated to be described 

: 1 8 ! by ‘the Standard Data DST record. A D-Floating constant, for example, 

he : has too large a value (8 bytes) to fit in a Standard Data DST record. 

; 1528 ! A “based variable’ in PL/I may require a complicated computation or 

; 1529 ! even a call on a compiler-generated thunk fo compute the variable's 

3 1 0 ! address. For these and other cases, a Trailing Value Specification 

: 1531 ! DST record must be used. Such a record includes a Value Specifica- 

3 1 ¢ tion which may be arbitrarily complex. 

; 36. 1534 ! Trailing Value Specification DST records are sometimes used to speci- 

s; 1335 ! fy both type and address information. An array with dynamic array 

as $ 0 : bounds, for instance, must be described in the DST if no descriptor 

3 15 0 ! exists in user poner at run-time. A Trail ng Value Specification 

; ! can be used to compute the entire descriptor for such an array at 
1538 0 ! b d h ire d i h 

: ! UG-time. e descriptor then gives both the array address an 
1539 0 : DEBUG-ti The d i h j both th dd d 

; 1540 0 : type information such as the element type and the array bounds. 
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THE STANDARD DATA DST RECORD 


The Standard Data DST record is A ps to Goyer tbe most simple scalar 
data osiects oye? A: int gers. tees ne-pe) oe numbers, and complex 
numbers. Fype ts regresented by the one-byte VAX Standard | 
Type code i Ms ost TYPE field. The value DSTS$K_BOOL is also 
accepted; it denotes that the data symbol is a Booléan variable qr 
value Shick’ is TRUE if the low-order bit is set and FALSE otherwise. 


The wolue ppess veces ion in the Standard Data DST record indicates 


WN 9 OONOVNE WH OOONOUE win 


DPAPEPEDPMAG AAs ££ EE 


WMVIVIVIVIVT DPUIVWIVSIV SV SIVSTSVSVSTS IIIS 
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' 

' 

i] 

' 

' 

' 

{ 

' 

' 

' 

' 

the symb value or address or how to compute the symbol's address. 

the details are found below. A 
; This is the format of the Standard Data DST record: 

' 
S ' Pwr eee ene woe wwe ne wen eee eee were ere eee ee sense weer eee eee ewe eee eee eee + 

byte DSTSB_LENGTH H 

i byte | DST$B_TYPE 

' tere ere oe nee ee ene eee eee Swe mwa ee oe ; eoece ee eee er oes + 

byte ' DSTSV_REGNUM ! DISP ! INDIR H DST$V_VALKIND ! 
5 i long } DSTSL_VALUE 
5 ' tore ree eereeee ROOM we Eee wm ORO RO OR Eee Oe Tee ee ee Seem omen} 
5 ! byte | DSTSB_ NAME t 
5 ! $emmmemmeee eee eee eee eee eee eee eeeceeeeeeeseseseeseseesosecessoes + 
5 var | H 
é The Symbol Name in ASCII 
: (The name's length is given by DSTSB_NAME) | 
5 i 
2 ' $eeeceeeeoeoceoeeceeooesoeseesoosoeeecoossoessoecososeooecoeoecec] + 

' 
5 ‘ 

‘ 
3 : Define the fields of the Standard Data DST record. These fields are also 

; used in many other DST records of similar formats. 

F 


FIELD DSTSSTD_FIELDS = 


DSTS$B VE LAGS 
DST$V_VALKIND 2)],! How to interpret the specified value 
DST$V_INDIRECT J,'i Set if address of address is produced 
' y indicated computation (do an 

! ndirection to ¢ ule address) 
DSTS$V_DISP = C 2, v_(3) J, | Set if content of DSTSL_VALUE is used 
: = a jsplocenen "att a register 

pect eq n DSTS$V 

DST$V_REGNUM =C 2, v_(4,4)], | Number of register used” * displace- 
n 


ment mode eddrogs Viset 


3: B_ @s ' Value-Flags (access information) 
- j 
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A ab ab Ah Ab Ab Ab Ab Ab ib ib ib all 


DSTS$L_VALUE = f 3 ae * Value, address, or b ° 
DSTSB_NAME = + } Count byte of the symbol name field, 
Tes a Lounted ASCII string 


S2eS33 


aR 


AAA AAAAAAAAAAA AAA AA AAA AP AAA AAA AOOOUIN 
INIA IPorororororororororny 


et ed etd td ad FOOD 


AAAAAAO 
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Fut" OOOwNO un fwits—00 
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! Define all special values that may appear in the DSTSB_VFLAGS field. If one 
! of these values appears mn that field, the DSTSL_VALUE field has some special 
! meaning indicated the special value. In oust cases, the DST$SB i sub- 
! fields have no meaning. Not all of these sper al values may appear in a 

! Standard Data DST record (see the comments below), but they are all Listed 

! here for conpieteness. Note that these values (with one exception) all have 
' the top four bits set--hence ney sonnet be normal VFLAGS values since the 

} REGNUM field cannot contain 15 (indicating the PC) in a normal VFLAGS value. 
L 


ITERAL 
DSTSK_VFLAGS_NOVAL = 128, A flag which indicates that no value 
s specified, i.e. the object 
being descr bed is at pe. This 


value may only appear in a Record 
i dst re ; se 


! 

! 

! 

! 

: Beg n § rd. 
DSTSK_VFLAGS_UNALLOC = 249, ! This value is DST$B_VFLAGS signals a 
! data item that was never 
! allocated (and hence has no 
} address). For example, PASCAL 
! does not allocate variables 
! that are not referenced 
' This value in DST$B_VFLAGS signals a 
' 
i 
i 
' 
' 
' 
! 


DSTSK_VFLAGS_DSC = 250, 
Descriptor Format DST record 
DSTSK_VFLAGS_TVS = 251, This value in DST$B_VFLAGS signals a 
Trailing Value Spec DST record 
DST$K_VS_FOLLOWS = 253, Value Specification Follows (allowed 


only in a Trailing Value xPec? 
A flag end iceting that DSTSL_VALUE 

contains a bit offset (used 

only for record components) 


DSTSK_VFLAGS_BITOFFS = 255; | 


! Provided the DBGSB_VFLAGS field does not have one of the above special values, 
! the DBGSV_VALKIND field indicates what kind of value or address is computed 
! by the value computation. The possible values of this field are defined here. 


LITERAL 

DSTSK_VALKIND_LITERAL = 9. ! DSTSL_VALUE contains a literal value 

DSTSK_VALKIND_ADDR = 1, ' Computation produces the address of 
} the data object 

DSTSK_VALKIND_DESC = 2, ! Computation produces the address of a 
: VAX Standard Descriptor for the 
; data ob ost 

DSTSK_VALKIND_REG = 3; Value is contained in the register 


whose number is in DSTSL_VALUE 


If the DSTSK_VFLAGS ole does not contain one of the special values listed 
above, then Ehe computation that produces the value or address of the data 
object proceeds as follows: 


1. If the VALKIND field gene ins STOK VALE IN LITERAL the symbol is a 
constant wnoeg value is given by thé DSTSL_QALUE field. Such constants 
can be up to 32 bits long. 


1Seseo-t9n4 33:93:88 “SBSSS0DASSS iaate:sncttexost.neo;1 2% 2s 


2. If the ng og field contains DSTSK_VALKIND_REG, the symbol is a vari- 
aple bound t register. The register number of that register is 
given by the “ps TSL VALUE field. 


3. Otherwise, the symbol is a yor ieble yish 8 neanres teter address. To 
compute that address, the DSTSL_VALUE field is picked up. 


4. If the athe e Hat bit is set, contents ef the register whose reg- 
eter number™ is 9 ven y oe sree - viens field is added to the value 
picked up from the U Vatue f 


5. If the + el IND vy* te is set, the address computed so far is treated 
as the address o yn that points to the actual data object. In 
other words, an ndipects on is done. 


6. If the value of the VALKIND field is DSTSK_VALKIND_ADDR, the address 
computed so far is treated as the address Of the data obj ject. 


7. If the value of the VALKIND field is DSTSK_VALKIND_DESC, the address 
computed so far is treated as the address Of a VAX Standard beser ip oe 
for the data object. The actual ecqrese of the object, oteng with 
other attr suces such as type and size, must therefore be re B nia P 
from that descriptor. 


SSSEEEEESESS 


S88 


PAPA AOOAO 
aN 
NOUS wiry 


Se 


As this jose ios an indicates, gogerately conot Scoted odéress oon utations 
can be spec in the Standard Data DST record. For example, the address 
of by | Scena formal econeter ya a cosine. passed by reference, can . 
described by making DST$V = AL. (for register AP) L_ VALUE 
(to indicate an offset or + na,! rom AP to get at the se ond longword in 
the or ry vector), DST$SV_DISP = 1 (to jogtsese that ofe't aVALUE is to be 
treat a displacement off AP), and DSTSV_INDIRECT cate an 
since the argument ue pacece by oy. Feterence). bst V_VALKIND = 
indir VALKIND_ADDR in this case. ere were - sed by descrip- 
sor owever, DSTS$V  VALKIND ghoul? be DSTSK VALE INKD DESC, with all other 
tields having the séme values as in the passed-by-reference case. 


Oe Se Se Se Se Se Se Be Se Se FH Se Se Se Se Ge Se Se Ge BH Se Se Se FH Se Se Se FH Se Ge OH Se Se Ge oe 
aa kt i at tk kk kt tk ts es as ts a ss ss 
te ee et ee 
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THE DESCRIPTOR FORMAT DST RECORD 


The Descriptor fy res re ord. is off when a VAX srener’e on 

or riptor must be inc re) mbo 
udes he gees tor d . AY bby ? T record 

the name s record is essentia t id of cet $ §9 the 

Standard ret “ést "record ex guse t that the D 2 

the © pee jal x. ue DST DSC and rh e DSTSL ALU E field 
ative byte offset ny Ne VAX descriptor Latér ; “Js BF 

this is the format: 


AOASOO 


SESSSPRESS 


+ seeece OOS OO 8 6 OOS 6 SOS SS OSS SS SS SSSS SSSSSSSSSSSSSSSSSSSSCSSSSCSCSCSS+} 


i byte | DST$B_LENGTH ' 


$ewmwwmweeweeweeooeeooeweeeoscosceccesesecccececcoesceccceccecon} 


i byte | DST$B_TYPE 


Goowwewoowcoeeoosecocowwesceoewesecowsecocececccccccececocecocees 


i byte | DSTSB_VFLAGS (= DSTSK_VFLAGS_DSC) i 


Geocecceecoeeeeweowwosececeoowowcowcesooescescooceecesoeccocoece$ 


i Long | DSTSL_DSC_OFFS ionet 


$oooeeeewoooecoweeeeoooeeeeesoscooseoeecoesoecocececoeccocccccece} 


i byte | DSTSB_NAME (also DSTSA_DSC_BASE) i 


Goeeceeccooseescowooussoecescesosescesssscesoso See eee eeeeeeooee eeeeee + 


SSSVERFENSS 


' 
! 
' 
! 
! 
! 
! 
' 
' 
' 
' 
! 
' 
! 
! 
' 
! 
' 
1 
' 
' 
! 
! 
! 
! var 
The Symbol Name in ASCII 

(The name's Length is given by DSTSB_NAME) 
! 
] 
' 
' 
4 
1 
4 
1 
1 
! 
' 
4 
i] 
1 
4 
' 
' 
i] 
F 


st a ss 


PEW 0 OONOUES WN — O OONOU FS WN 


bore ee em eee ene eee Fee e eee meee meee wnt oer e oo oroeee Sete eee meee eon r ee 


i long | DSC$B_CLASS { DSCSB -DTYPE i DSC$W_LENGTH 


yy wee es eee see eee s ee ee reece socom sone + 


i tong } DSC$A_POINTER 


Geowceeooeecooeeeceooeseecesesesooe ee ee ee eee eee See eee eee eeeeeeee 


i var 
Other VAX Standard Descriptor Fields 


depending on the descriptor class 


a Fee ee e222 e222 22202 OSS SS SSS SSS SSS SSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSESeSee 


i Define the fields of the Descriptor Format DST record. 


SN NNN 


FIELD DSTSDSC_FIELDS = 
DSTSL_DSC_OFFS =C{€3,t_ J, tea in bytes te to cigner tptor 
DSTSA_DSC_BASE =(€ 7, AL J] i Descr iptor starts. at this loc- 
: DSTSL_DSC_OFFS 


TES; 


Be Se Se Ge Ge Be Be Fe Se Se Ge Fe Fe Se Se Se Se Ge Ge Ge Se Ge Se Se Ge Ge Ge Ge Se Se Ge Se Se Ge Se Se Ge Ge Ge Se Ge Se Se Fe SH Ss Se Se Se Se Se Se Se Fe Se Se ae 


ma a i a a ae a at ss 9 a = 8 = a ss a as a 8s Lt a a 


nN 
PLL 


! Note that the address of the descriptor is computed as follows: 


1besto-96 33:98:88 SSSELOBASBStiRate gnc dtexost.rea;1 °° <23s 


174 : 
108 : DST_RECORDCDSTSA_DSC_BASE) + .DST_RECORDCDSTSL_DSC_OFFS) 


SAN NNN 
PUPS SVISISISISISIS 


pe 
COCO ONIN NIN NSN NNO 


SSBLEAL 


> > > >) 
sess 
Lar 


z 


>] 


Seeccsssse 


rr re ee ee eee 


Be Se Ge Se Se Ge Fe Be Ge Se Se Be Ge Fe Se Fe Ge Fe Se Fe Ge Ge Se Se Se Se Ge Se Ge Ge Se Ge Se Ge Se Ge Ge Se Ge Se Se Se Se FF SSeS Oe Oe Se Se Oe Ge OHS Se we 
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THE TRAILING VALUE SPECIFICATION DST RECORD 


The pdb Value Sgectticotton DST record jis used when an expanded 
value specification is needed to compute a data syebo s value or 
address. It includes a Value Speg { cation directly in the DST rec- 
ord right after the name field. This record is essentially identical 
to the Standard Data DST record except that the DST VE LAGS field has 
the special value DSTSK_VFLAGS TVS and the DSTSL_VALUE field is a 
relative byte offset to the Value Specification [ater in the record. 
This is the format: 


Poem eset eee sees een meme Emmet e sete nes eres en ee te ete sem oem ee. wen eee} 


a I, 1 a os Ee eal 
Wr) postbapbevitrneditinngatere Ber toantaniendiaiarninaiiaa 
ag Rt ae Ba wh nt nee Ss TS, 
long } DSTSL_TVS_OFFSET joowns 
pie, EO. ic wnt Bons Bo a tna tree 5 CR deal 
var 


The Symbol Name in ASCII 
(The name's length is given by DSTSB_NAME) 


} cocece. cscs ccescoeece 


A 
f 
i 


var 
DST Value Specification 


} eo cecccn } cocccccececs 
Se 


Define the fields of the Trailing Value Specification DST record. 

IELD OSTSTVS_FIELDS = 
DSTSL_TVS_OFFSET = (3, L. J, 
DSTSA_TVS_ BASE =(€7, AL J] 


' 
i 
i 
' 
' 
' 
' 
' 
' 
' 
‘ 
! 
i 
i 
i 
i 
i 
i 
F 


Of tees in bytes to trailing Value Spec 

rom DSTSA_TVS_BASE 

Trailing Value Spec’starts at this 
location + .DSTSL_TVS_OFFSET 


3 
3 
3 
3 
3 
3 
3 
g 
$ 
3 
; 
. 
2 
3 
3 
3 
3 
g 
. 
e 
: 
; 
. 
. 
. 
: 
: 
. 
. 
; 
. 
: 
° 
: 
: 
: 
: 
: 
* 
‘ 
o 
: 
: 
: 
: 
: 
: 
: 
. 
: 
: 
: 
. 
: 
: 
. 
: 
3 
: 
: 


TES; 
! Note that the address of the trailing Value Specification is computed as 
follows: 
DST_RECORDCDSTSA_TVS_BASE] + .DST_RECORDCDSTSL_TVS_OFFSET) 
i 
i 


7 . 
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! Later in this definition file. 


— 


a ad at td ad od FOOD 


MOOWDNOUES WN“ OOODNOUSE 


WW 
wr 


parr 


vd 
uw 


20000 » 


Www 


te 


a ee ee a a dd 
= 


SGOOGOOOOSOOSSSCOCOOCOOOCOOOOOOOOOOOOOOOOOOO 


° 
° 
o 
& 
. 
° 
o 
- 
. 
o 
. 
e 
. 
° 
> 
° 
* 
° 
. 
° 
. 
° 
. 
e 
-* 
ao 
2 
o 
* 
° 
. 
° 
. 
. 
* 
° 
. 
. 
. 
° 
. 
° 
. 
° 
. 
o 
. 
° 
. 
o 
- 
° 
° 
° 
° 
° 
. 
. 
a 
a 
° 
o 
° 
7 
° 
. 
° 
7 
° 
° 
. 
° 
. 
° 
© 
om 


QOustwn—OO0@® 


FREE 


byte 
byte 
byte 
Long 
byte 
var 


var 


? 
1$-Sen-1984 38:09:08 
THE SEPARATE TYPE SPECIFICATION DST RECORD 


The Separate Type Speci tteat ton DST reser? is used when 
of the symbol being described is too complex to be cone 
a one-byte type code or a VAX Standard gesce jotor Th 

ned ately followed by a Type Specit cation, 
or Enumeration Type Be 
of the data symbol. (Only Cont 


ly identical to that of the Standard Data DST record 
a Trailing Value Spec steation if nocessery to describe 
value or address. This is the format of the record: 


bee sens enr ee sen menemar es ae ane seo rn ewwrarwrornrrewzoracear= = Sena ewe ewer ee + 


H DST$B_LENGTH H 
! | DSTSB_TYPE (= DSTSK_SEPTYP) 

H DSTS$B_VFLAGS 

H DSTSL_VALUE H 
i DST$B_NAME 

The Symbol Name in ASCII 

(The name's Length is given by DSTSB_NAME) 

. eeecee Se eee ee eee e2eeeeee@ Seeeeeaeoeeaoaeees wevwrwrranrr ee kg=ef-ee ee ew ee eee ee Be | 

A Trailing Value Specification or nothing, 

depending on the value of DSTSB_VFLAGS field 

Sere JinintaiiniendeinnNeiKuetiianReRaias 


K-11 Bliss-32 v4.0-74 p 
VSDSSSDUAIBS CTRACE. SRC ITBKDST.REQ; 1 


Record Begin, 

n DST eycere which describes the data type 
nuation DST records may intervene.) 

The format of the Separate Type Specification DST record is essential- 

It may contain 


Pe ee 


y tr trtytytytytyty ret ye 4 
PUPS 


WMO OONOUS WN O0Oo~ 


SEES 


NOULSWN OOO 


‘G2 Cd Cd CO Cd C9 Cd C9 CD CO. CD 
SSN NSO OO 


S060 0090 IG 
Wr—O0Oo 


SeSSe 


SOOOSOOOSOOOOOOOSOCSOSSSSSOSOOSSSOSCSCOCOOCOCSCOOOOOOCOOOCOCOOOOOOOOO 


ee ce ee ce te ce ce ee ee et ce ce ed ce cee ee ce ed ce ee ce ce ce ee el ee ce cee cee el ce a ce ce cee cee cel cel cel ce eel cl cel ee cee cel el 
oO 


Be Se Be Se Se Ge Ge Fe Fe Se Ge Ge Ge Ge Se Fe Fe Sse Ge Ge FHSS Se FH FH BH Sse Se Ge Se Sse Ge Se Se FF Se Se Ge Se Se FESS Ss Ge Se Sse Ge Se Se Se Se Se Se Se Se eees 
: > 


? 
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DST VALUE SPECIFICATIONS 


A DST yolug speci fication specifies the value or address of some symbol. 
Value Specif gation can occur in a number of places in the Debug Symbol 
Table. The simplest forms of Value Specit cations occur in the Standard 
Data DST record. A somewhat more complicated form occurs in Descriptor 
Format DST records where a VAX Standard eeecripter s included in the 
DST record to give more cea toy gedrese nformation (and type informa- 
tion). The Trailing yous pecification DST record has a simple five- 
byte Value Specification * the beginning of the record which points to 
a more canpeee Value Specification at the end of the record. That more 
complex Value Specification can be any kind of Value Specification, in- 
cluding the most general forms. 


In addition, Value Specifications ney occur in a number of Type Speci- 
fications. In these cases, they typically generate values (as opposed 
to addresses), such as subrange pounds for a subrange data type, or they 
enerate full VAX Standard Descriptors in order to specify some sort of 
ata type, such as a dynamic array. 


ALL Value Specifications start with one byte, the DST$B_VS_VFLAGS field. 
In Standard Data DST records, this field and the DSTSB_VFLAGS field are 
synonymous. If this field has one of the special values DSTSK_VFLAGS_xx 
described in the Standard Data DST Record section above, the format o 
the Value Specification depends on that value. Otherwise the VFLAGS 
field is interpreted as a set of subfields, ere DSTS$V_VS_REGNUM 
DSTSV_VS_DISP, DSTSV_VS_INDIRECT, and DSTS$K_VS_VALKIND. “This is also 
described in detail Tn the Standard Data DST Record section above. 


STANDARD VALUE SPECIFICATIONS 


As indicated above, if the DST$B_VS_VFLAGS field does not have a special 
value, the Value Specification is a Standard Value Specification and has 
the following structure: 


teow em een mowe wee eo ee ese woe reo eee bomon ace 
' 


byte } DSTS$V_VS_REGNUM 


ear eccoeccae ee 


DSTSL_VS_VALUE 


Ot ee te ed et te ttt tee 


Define the fields of the various kinds of Value Specifications. Also define 
the declaration macro. 


FIELD DSTS$VS_HDR_FIELDS = 


SET 

DST$B_VS_VFLAGS = - B. J. ! Value-flags (access info) 
DST$V_VS_VALKIND a - V.(0,2) J, ! How to nterpret the value 
DSTS$VVS~ INDIRECT = € 0; v7(25 3," § Set to get indirection 


? 
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Length of Value Spec in Bytes 
not counting the VFLAGS 
and VS_LENGTH fields 


~ 


904 DSTSV_VS_DISP = ° v_(3) J,. ! Set for register displacement 
90 DSTSV_VS_REGNUM = » V2(4,4) J; ! Register number for indexing 
90 DST$L_VS_VALUE = ev : : Value, sddress. or bit offset 
90 DSTSL_VS_DSC_OFFS *tLit,t. J. ! Offset in ortes to descr gyor 
90 } rom DSTSA_VS_DSC_BASE 
90 DSTSA_VS_DSC_BASE =(€5, A], ' Descr ptor starts at this loca- 
i tion + DST$L_VS_DSC_OFFS 
- DSTSL_VS_TVS_OFFSET *{ t,t. 2. ! Offset in bytes to Value zee 
; from DSTSA_VS_TVS_BAS 
DSTSA_VS_TVS_BASE *{€ $5, a, 1. ' Value Spec starts at this loca- 
: tion + DSTSA_VS_TVS_OFFSET 
DST$W_VS_LENGTH =Ci,wW.], 
' 
' 


DODOODOODODDODDOODOODODODOO00O 


FS HWAW AWA WIND POPINPONPIPONPINNNS 2 2 Ss SS Se 


DST$B_VS_ALLOC = f 3, BL }. Allocation Tndicator 
DSTSA_VS_MATSPEC = 4, AL Location of Materialization 
Specification 
TES; 
MACRO 
DSTSVAL_SPEC = BLOCKC,BYTE] FIELD(DST$VS_HDR_FIELDS) %; 
' The following Literal values may appear in the DST$B_VS_ALLOC field. 
LITERAL 
DSTSK_VS_ALLOC_STAT = 1, ! Value is static 
DSTSK_VS_ALLOC_DYN = 2; ! Value is dynamic 


! Define the fields of the Materialization Specification. Also define the 
declaration macro. 


FIELD DSTSMS_FIELDS = 


DONAOUEWN —$O OONOUES WN OOD ONOUE WO DODNAUM 


OWOOODODOOODOOODO 


DSTSB_MS_KIND =({0, 8.1], ! The kind of value produced 

ih; Mag a ={C{ 1, é ‘ ire apgnantan whereby produced 
= e oe . a S 

DSTSV_MS_NOEV 5 » Vt j }- ’ Purpose of this bit not clear 

DSTSV_MS_ = - V4) J, ! Include Gunny argument on call 

DSTSA_MS_MECH_SPEC = » AL }: ! Location of Mechanism Spec 

DSTSL_MS_MECH_RTNADDR = » te Routine address for call on 


compiler-generated thunk 


MACRO 
DSTSMATER_SPEC = BLOCKC BYTE) FIELD(DSTSMS_FIELDS) %; 


: The following values may appear in the DSTSB_MS_KIND field. 


LITERAL | 
' The value is a byte address 

! The value is a bit address (a longword. 
byte address plus a lonqword bit 
! r) 
q 


NOUS WN OO DONOUE WIN O 


— 
Pid 
4 
o 
~@ 
“ou 
mo 


PPP & 


fset from the byte address) 
The value is a bit offset (normally a 


ee ce ee ce ee ce ee ee el ce eel cel el ce ee a ee el el ee ce ec ee et el el el ee ce ee el cel cl ce el et el el cece cl cl cl cee el cel cel cel el cel cel cl cl el 


SOODOOOOOOOSOSOSOSOCOOOCOCOSOSSSSOSSOOSSOSOSSOOSCOOCOOOOOOOOCOOOOOOOOOOOCOO 


Be Be Be Be Be Be Ge Se Se Ge Be Be Fe Se Be Se Be Se Fe Se Ge FH Se Se Ge Ge SH Ss Ge Ge Se SF Ge SESS Se BF SH SS Ss Os Oe Ss Se Sse Ss Ss O5 Ss Oe Se Se Se Se Sees 


Owooe 


& 


DST$K_MS_BITOFFS = 3, 
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. 
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. 
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. 
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o 
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. 
7 
. 
c 
. 
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- 
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. 
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. 
° 
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7 
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. 
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° 
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} bit offset ives the start of a 
DSTSK_MS_RVAL ; The value 
' 
' 


recor sat for record components) 
= ¢ teral value (constant) 
DSTSK_MS_REG & Fe ! The ae register number (the 


S a register address) 


DSTSK_MS_DSC = 6; i the value is a VAX standard descriptor 


S5S352333 


The following values may appear in the DSTSB_MS_MECH field. 


SeGe Fe Se ee Se Se ee Ge Se Se Se tee 
at as SS ns ss oe st 


970 ! 

971 LITERAL 

358 DSTSK_MS_MECH_RTNCALL = 1, ! Routine call on a compiler- 
97 i enerated thu nk 

974 0 DSTSK_MS_MECH_STK = 2; i DST Stack Machine routine 


eae a ee Ey tay Cte eden ee Eade ee aE See PTE Ae eR Ee ee ee Team ae Tee ge 


WOOOOOO 
COO Oo INA 


Wn —OO0OnNOu 


Uae 


COOOOSOOSOSCOCSCOCSCOCOOOOOCOCOCOCOOOOOOOOOOCOO 


WOOOOOOO 


co 
oO 


POPORY — et tt 
Mun 


Sasssssssesess 


Sse 
MEwn— 


io 


Mrororonong 
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DESCRIPTOR VALUE SPECIFICATIONS 


If the DSTSB_VS_VF'.AGS field ay fhe pecial value DSTSK VPLAGS DSC. 
this is a DeScriptor Value Specification. Such a Value pgc ii icat on 
contains an offset relative to the end of the Value Specification that 
points to a VAX Standard Descriptor later in the same DST recor, That 
descriptor then contains the actual address that the Value Specifica- 
tion seeks to specify. This is thus the format: 


een one eeeceeneeee See eee eeeeee SSeS eS SSS SSS enenenea owe eee > 


byte H DSTSB_VS_VFLAGS (= DSTSK_VFLAGS_DSC) H 
long } DSTSL_VS_DSC_OFFS gene 
var | DSTSA_VS_DSC_BASE Se 
Other Fields in DST Record 1 
tocencceccnnwnnnnnnnnnnnennnne a necencnnnncnnnannnenae= ee 
var ' i<oot 
VAX Standard Descriptor Giving Symbol Address 
teceewwnnnnnnnnnnnnnnnncnnnncnnnnnnnnnnenneeneneeennnnnnnnnnennee ; 


The address of the VAX Standard Descriptor is computed as follows: 
DSC_PTR = VS_PTRCDSTSA_VS_DSC_BASE] + .VS_PTRCDSTSL_VS_DSC_OFFS); 


: 


eee ee ge OP 2 ES ERE ots Ie RSIS ee ig =F Sc as SU RT SR eT Te, CE pen ee ek eC hada se ek eae ae “Deena 


oOo 
— =S 


WR O OONOVELSWN —"OOONOUL wr 
OOOCOCCOCOOSOOSOSOOSSOSOSSOSSSOCOCOOS OOOO OCOOOOOOCOOOOOOO 


WA AIAPOPUPIPOPINPONONNDS 2 2 SS OO we 


SOOOCCOCOCOCOOCOOOCOCO OOOO OOOOOOOOO 
SEE 


Ww 


ERERRLRELE 
M—OCODVNOUSWN—O0OW 


ooo 
ww 


ror 
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TRAILING VALUE SPEC VALUE SPECIFICATIONS 


If : DST$B si} VFLAGS field has the A+: Se v re bsTsK. VFLAGS_TVS, 
this : a Trailin ng Yetue Spe c¢ Value Sees. f Such'a Value 
Spee tt ication conta ns a po inter rye A to DSTA. VS_TVS_BASE that 
nts to another Val “ Spec | cation Later in the” same DST record. 
his second Value Specifica jon is normally of the most general and 
pover tut form of ya ue Spec a f on, my y che is ba yetue Spec- 
ication. n effect, the ie l sng ve Val ue qnret, ormat ve-byte 
veiue Specif cation (small enough o fit ina Bete DST LoSeha) which 
it nts to a larger very Specif cotton olaownere n the same DST record. 
his larger Value Specification ba be arbitrar \y Large and complex 
in order to do whatever ceneuces on is necessary to obtain the desired 
value, address, or descriptor. 


This is the format of the Trailing Value Spec Value Specification: 


Peewee eee ee eer eseeeeee es eeeeeseseeeoceoeseeces Seer eeeeoeeeooesesee= + 
byte ! .* “DSTSB. vs _VFLAGS Lb DSTSK _VFLAGS_TVS) H 
Long H DSTSL “VS TVS “OFFSET jot 
var | DSTSA_VS_TVS_BASE be 
Other Fields in DST Record 
jeerenseneuencetesenneneuneenssnmneeremerenenunmennrernnenrnetenn se 
var i<oo4 
The Trailing Value Specification 
(Normally a DSTSK_VS_FOLLOWS Value Specification) 
' 1 } . 
$runeesiiensesenseeeeerensennenubesuienenseuesuerieeenisreeeeS + 


The address of the Trailing Value Specification is computed as follows: 
TVS_PTR = VS_PTRCDSTSA_VS_TVS_BASE] + .VS_PTRCDSTSL_VS_TVS_OFFSETI; 
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OOo0CoO 
Wry 


SRRERAN 


VFA OOONOULW 


SOSOOSOOOSSSCOSOOSSCOOSCOSOSSCOSOSOOOOOCOOOCOOOOCOOOOOOOOOOO 


SoEee 


"ODOC USWN—OVOW 


polo jolelolololo) 
SNS 


oooo 
oocp cD 0D 


08 
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VS-FOLLOWS VALUE SPECIFICATIONS 


If the DSTSB_VS_VFLAGS field has fhe pecial yalye DSTSK_VS_FOLLOWS, 
this is a VS=Follows Value Specification. This is the moet general 
and powerful form of Value spec tt ication. The sp0¢ fication itself 
can be arbitrarily long, but it can also do an arbitrarily complex 
computation in order to compute the desired value, address, or de- 
scriptor. This is the format of the VS-Follows Value Specification: 


oar eanarcee eee ene mee moo on Pere n we oem emo were none wea mee Sm meee + 


Nh een Ree ee eee OL. cseuianeuel 
ek, i a RO 
byte | DST$B_VS_ALLOC ' 
4 Seer ~ DSTSA_VS_MATSPEC SSS Se ae H 
A Materialization Specification 
eciideben sonemmainplineniliaiciie sbtiabentinlideahaipliiiis seecaiiiaaning : 


A VS-Follows Value Specification contains a Materialization Specifica- 
tion which indicates how the value is materialized. This specifica- 
tion indicates what kind of value is being produced, by what mechanism 
it is proeuced. and in detail how it is produced. it also contains 
some flag bits. : 


The kind of value being produced can be a $g-pit byte address, a 64-bit 
bit address (a byte address followed by a 32-bit bit offset), a bit 
offset (relative to the start of a record--used only for record compon- 
ents), a literal value (a constant or R-value’), a register address, 
or an actual VAX Standard Descriptor. VAX Standard beseriptors are 
mainly produced by Value Specification within Type Specifications where 
a descriptor must be pull to describe a data type such as an array 
type with run-time subscript bounds. 


Values can be produced by two mpghentons, One is a routine call on a 
comp! er-generated thunk. In this case, the compiler generates a rou- 
tine in the object code watss when called produces the desired value. 
The address of the routine is specified in the Mechanism Specification. 
The qther mechanism is a DST Stack Machine routine. The DST Stack 
Machine is a virtual pach ing which DEBUG eoulates, To use it, the com- 
iler generates code for this virtual machine which, when executed at 
EBUG-t ime produces the desired value. The DST Stack Machine form of 
Mechanism Sper scat ton constitutes the most general and powerful form 
of value specification supported by DEBUG. 


Be Se Se Se Be Se Ge Se Be Oe Se Ge Ge Se Se Se FH FH TH Ss Ge Se Se Oe Ss Se Se Se Ss Oe Se Ss Ge Se FF Se Se Se FH Os Os Se Se Se Se Se FHS Seas 
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uw 


CALLS ON COMPILER-GENERATED THUNKS 


hed Routine Call Mechanism ppec )ticet ton specifies the ereee of a 
pi tor=genereted routine (a thunk) which DEBUG can cal ef gertore 
the Paes ired value computation. Hh form of Mechanism Specif Sosten 


‘ 

11 ed pe used for PL/I SED" var jables since the address of such 

\§ vari syle can depend on the value returned by ., ueoraget ne funetion. 
1 S$ case, the Mechanism. Spee cification consists of a f reete lLongword 
13 My ng the edéress of the compiler-generated thunk to cal 
\$ This is the format of the eg he vetye Specification when the Routine 
i Call Mechanism Specificati 
19 

0 Nee errr eo eewoooooe=+ 

1 byte H DSTSB_VS_VFLAGS (=DSTS$K -VS. FOLLOWS) H 

5 word ! DSTSW_VS_LENGTH (= 8) H 

5 byte H DSTSB_VS_ALLOC (= DSTSK_VS -ALLOC DYN) ! 

; byte H DSTSB_MS_KIND H 

3 byte H DSTSB_MS_MECH (= DSTSK_MS MECH RTNCALL) H 

1 byte H DSTS$B_ MS _FLAGBITS ! 

: long ! DSTSL MS MECH _RTNADDR ! 

5 


The called routine is passed the address of a vector of register velues 
as its one argument. This vector contains alt register value for the 
scope (call frame) in which the symbol having this Value sea fTeation 
is declared. The ve tor contains the values of registers ~ AP, 
FP, SP, PC, and PSL that order. The routine is allowed to A "aut 
such values in its Ba Mes Fas. but is not allowed fo change the con- 
tents of the register vector. fn addition, the routine is passed the 
value of FP (the Frame Pointer) in register R1. 


The value of the routine should be returned to DEBUG in register RO. 


rhe DSTSV_MS_DUMARG bit should be set in the DSTS$B_MS_FLAGBITS field if 
he celled. rut ing 8 qevecss to return a value longe? than one longword. 
it pst s set, the address of an os teyere Tey -lLongword) 
buffer ie open A the firs argument to the called routine with the 
expectation that the routine s value will be returned to this buffer. 
The address of the register vector is then the second argument. 


ee ee ce ee ee ee ee ce cD ce ce ce ce ce ee a ce ce ce ce ce ee ee ce ce cee el eel el el el el el 


ed ed eed ee eee ee 
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byte 
word 
byte 
byte 
byte 
byte 
var 
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THE DST STACK MACHINE 


The DST Stack Machine is a virtual machine emulated by DEBUG. This 
machine can push and tee values on a stack and {30 perform a yertety 
of arithmetic and a cal 7° erations. It can also call compiler- 
generated thunks,. tack Machine is used when a veiue my must 4 
computed at bEBUé-tine and the Standard Format velus Spec cation 
not adequat ane @ comp Ler=genorates ¢ es to do the whole com utation 
seems undesirable. In such cases, the cone! ler cop generese a Mecha- 
aie Specification which copstets ¢ code for the Stack Machine. At 
DEQUG “time, when the value in question is needed, DEBUG will interpret 
this code until the STOP artettt on is encountered. The value that 
cone nna on She top of the Stack Machine stack is then taken to be the 
esired value. 


The format of the whole Value Specification when a DST Stack Machine 
Mechanism Specification is used is as follows: 


\ . * OSTSU. VS “TENGTH i 


gwen seen en meer erenrcwococes] a — Serr eeree sees eee ee ee eee + 


H DSTSB_ .VS -ALLOC ' 
DSTSB. MS “KIND i 


Sere eeceses eeecceesecosoceeecescos Seeewwwoeoesoesoeeeoseoccecoes$ 


DSTSB_MS MECH G _DSTSK MS -MECH_STK) H 
DSTSB_ MS “FLAGBITS 
“DSTSA “MS -MECH_SPEC 


+ 
DST Stack Machine Routine 
+ 


Here the DST$8_ vs gL OC field should have the value DSTSK_VS ALLOG DYN 
if any kind of ad Gress is computed and DST$K_VS ALLOG. STAT if feral 
value (a constant) computed. The need for this fiéld is not clear 
since DEBUG ignores it at present. 


The stack upon which the ue Stack Machine operates consists of 256 
locations where each loca s a longword. The stack gro He to toward 
gnayier addresses and shr nike severe 7 ereer addresses; in this regard 
Like the VAX cal steak. A OST syece mace ne Rout ioe consists 
of a sequence of Stack Machine instructions endi » TOP jastruss 
tion (DSTSK_STK ise When the machine Stops. ft e tes ocation or 
locations of thé stack constitute the valu th *.{3 rgut ine. The Length 
of the value is determined by the DSTSB_AS * IND fiel 


The DST Stack Machine supports the instructions tabulated in the re- 


et 


REAR |= OOODNAVNES UN “OODLE wry 
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mainder of this section. Each instruction consists of a one-byte op- 
ode followed by zero or more operand bytes, depending on the op-code. 
n this description, the ‘‘top’’ stack cell refers to the most recently 
pushed cell still on the stack and the ‘second’ cell refers to the next 
most recently pushed cell still on the stack. Each cell contains a 
longword value. 


Define the Push Register instructions. These instructions res the indicated 
register value on the Stack Machine stack. The register values are taken from 
the scope (call frame) of the symbol for which the value is being computed. 


ITERAL 

DSTSK_STK_LOW = Q, ! Lower bound for range checking 
DSTSK_STK_PUSHR = 0, ! Push the value of register RO 
2b Ul He = 1, ! Push the value of register R1 
DSTSK_STK_PUSHR = ¢: ! Push the value of register R 
DSTSK_STK_PUSHR = 3, ! Push the value of register R 
DSTSK_STK_PUSHR4 = 4, ! Push the value of register R4 
DSTSK_STK_PUSHRS = 5, ! Push the value of register R5 
DSTSK_STK_PUSHR = g. ! Push the value of register R 
DSTSK_STK_PUSHR = 7, ' Push the value of register R 
DSTSK_STK_PUSHR = . ! Push the value of register R8 
DSTSK_STK_PUSHR = ! Push the value of register R9 
DSTSK~STK- SHRI = 16, i! Push the value of register R10 
DSTSK_STK_PUSHR = 11, ! Push the value of register R11 
DSTSK_STK_PUSHRAP = \¢- ! Push the value of the AP 
DSTSK_STK_PUSHRFP = 15, ! Push the value of the FP 
DSTSK_STK_PUSHRSP = 14, ! Push the value of the SP 
DSTSK_STK_PUSHRPC = 15; ! Push the value of the PC 


Define the Push Immediate instructions. These instructions are used to push 
constant values on the Stack Machine stack. The constant value to push comes 
immediately after the instruction op-code. for the signed and unsigned in- 
structions, the value to push is zero-extended or sign-extended to bits 

as appropriate. In the gsee of the Push Immediate Variable instruction, the 
eyte after the op-code gives the byte length of the constant value to push. 
The constant value to push then follows immediately after that length byte. 
The constant value is zero-extended to ghe nearest longword boundary on the 
high-address end and the resulting block is pushed onto the stack. 


ITERAL 
DSTSK_STK_PUSHIMB = 16, ! Push Immediate Byte (signed) 
DSTSK_STK_PUSHIMW = 17, ! Push Immediate Word ts igned) 
DSTS$K_STK~PUSHIML = 8, ! Push Immediate Longuord (signed) 
DSTSK_STK_PUSHIM_VAR = 24,  ! Push Immediate Variable 
DST$K_STK-PUSHIMBU = 25,  ! Push Immediate Byte Unsigned 
DSTSK_STK_PUSHIMWU = 26; ! Puch Immediate Word Unsigned 


‘ Bering the Push Indirect instructions. For these instructions, the top stack 
s 


cell opped and the one, two, or four bytes at the address given by the 
: ¥ i. 3 tts and pushed on the stack. For the 


bits and 


ged cell are sign extended to 
unsigned instructions, the value 
pushed on the stack. 


s instead zero-extended to 
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t 
LITERAL : 
Rb SS UE ot bey = 20, ! Push Indirect Byte (signed) : 
DSTSK_STK_PUSHINW = 21, ! Push Indirect Word (signed) ; 
7 42h BAL a it hs = 22, ! Push Indirect Lenqwere (s gned) : 
7 DSTSK_STK_PUSHINBU = 27, ! Push Indirect Byte Unsi ened : 
78 ete” sega: = 28; ! Push Indirect Word Unsigned : 
7 ; 
a ! Define the arithmetic ‘onl Logteal snesrust tens. These instruction pop the 3 
7 ! top two cells on the stack, perform the ndicated operation on these operands, 3 
and push the result back onto the stack. : 
§ LITERAL 3 
DSTSK_STK_ADD = 19, ! Add--The top two cells on the stack : 
i are popped from the stack and 3 
5 i added together. The resulting 3 
i sum 1s pushed onto the stack. é 
DSTSK_STK_SUB = 29, | Subtract--The second cell on the stack 3 
i is subtracted sree the top cell. : 
34 i Both are popped | rom the st tack. 3 
i on 3 A oh orirerence s then 3 
91 i d onto the 3 
35 DSTSK_STK_MULT > i nultiplyorthe top two oo cells are : 
3 i plied. from the stack and multi- 3 
94 i lied. The resulting Sroguss is : 
95 i en pushed ents the s 3 
+ DSTSK_STK_DIV Fee Dividensthe top stack cell s “Sivided : 
."] i by the secene stack cell. th 3 
98 i are popped f rom the stack. Their 3 
99 gust! Pent s then pushed onto the : 
1 DST$K_STK_LSH > Logical *ehitteeshite the second stack ; 
¢ i ell by the number of b - iven : 
i by the top greck cell: pie each 3 
i eperende and push we A. 3 
5 i ond cell on the s F 
DSTSK_STK_ROT = 33; | Rotate--Rotate the onesel: st aa cell 3 
i 7° he tunber of bits given ne? 
i the top stack cell; pop both 
: operands and push the rotated 
19 ! second cell on the stack 
1 
i§ ! Define the Copy and Exchange instructions. These instructions make a copy 
\3 of the top stack cell or exchange the top two cells on the stack. 
\¢ LITERAL 
1 DSTSK_STK_COP = 34, ! Copy=sk e cuore of the top stack cell 
1 i ed onto the stack 
1 DSTSK_STK_EXCH = 35; aa. top two stack cells are 


interchanged 


| Def ing the Store instructions. Following the op-code, these instructions 
! contain a byte which is interpreted as a signed offset into the stack. The 
! low-order byte, word, or longword of the top stack cell is stored into the 


MEW —OO0® 


Rarofoporory 


eV... CC... 4c" _.0°.:°:°:°0°0°:.:°:...VSxS3SexX__ nm nm mnmnm—nm—n re —=_e_e_e_eeeeeeeeeeeeeeeee et = 


' byte. word, 9 Lenguore iven by the current stack gg inter plus four plus 

: the signed offset into the stack. (In short, the offset is an offset from 

! the second stack cell.) After that, the top stack fe is popped. These 

! instructions permit values to be stored into stack locations other than the 

; top or second stack cell. 

LITERAL 
. DSTSK_STK_STO_B = g. ! Store Byte ‘nto Stack 

2b a STK_STO_W = 3/7, ' Store Word into Stack 

DSTSK-STK_STO_L 8; ! Store Longword into Stack 


! Define the Pop instruction. This instruction simply pops the top stack cell, 
meaning that the top stack cell is removed from the stack and discarded. 


LITERAL 
DSTSK_STK_POP = 39; ! Pop Top Stack Cell 


! Define the Stop instruction. This instruction stops the DST Stack Machine and 
! is required at the end of every DST Stack Machine routine. Whatever value is 
! Left at the top of the stack when the Stop Tostruction is executed is taken to 
! be the value of the Stack Machine routine. This value may be a longword (a 
! byte address, for example), two Longuerés (byte address and bit offset), any 
! size literal value (an H-F loating literal, for instance), or a full VAX Stan- 
H dard Descriptor, depending on the value of the DSTSB_MS_KIND field. 
LITERAL 

DSTSK_STK_STOP = 23; ! Stop the Stack Machine 


Define the Routine Call instructions. These instructions call a compiler- 
enerated routine (a thunk) whose address is given by the top stack cell. 
efore the call actually occurs, the top stack cell is popped. The value 

that is returned by the thunk is then pushed onto the stack. 


The Routine Call instruction works as follows. The address of the thunk to 
to be called is taken from the top stack cell. The top cell is then popped. 
The thunk, which is called with a CALL instruction, gets two arguments. The 
first argument is the address of a vector of re \stet values for the scope 
(call frame) of the symbol to which this yotve pecification belongs. T ; 
vector contains the values of req sters RO - R11, ° ° » PC, and PSL in 
that order; the called thunk bs ree to read any value sj wants from this 
vector but may not store into t. The second parameter is a pointer to the 

top of the DST Stack Machine stack after the thunk address has been popped. 

A Stack Machine routine gen thus gompute arguments to the thunk and push them 
on fhe stack before push ng the thun address and call ng the thunk. In 
addition, the value of FP in the syabot S$ scope is passed to the thunk in 
register R The routine’s value is expected to be returned in register RO. 
This value is pushed onto the stack. 


The Routine Cail With Alternate Resyrn instruction works this same way except 
that the address cf an or teuere buffer (4 longwords) is passed to the thunk 
as the first arguaent. with the register vector being the second argument and 
he stack address being the third argument. In this case, the routine value 
S expected to be returned to the octaword buffer, not in register RO. The 
whole octaword buffer is then pushed onto the stack. 
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~SIKR TNCAL 5 19: ! Routine Call ( Sve alue returned in RO) 
SK_STK_ RINCACL SALT = 41: | Routine Call h Alternate Return 


' 
LITERAL 


! Define the Push Record Address instructions. These peetvsries ush the 

! address of the outer-most or inner-most record structure for which the cur- 
! rent Byadol is a record component. inary are used for conetryct) ing VAX Stan- 
' dard Descriptors on the Stack Machine stack when some pert, e ee Gecer ptor 
' depends on some other otapenens of the same record. In nstance, 
! the subscript bounds rray component of a record A. fA on another 
gg. component of that record: n such cases, the only way to get the address of 
! that oth ¢" component in the current recore is to use one of the Push Record 
! Address nstructions. The Push Uuter Record Address nstruet fon pushes the 
' address of the outer-most record of which th current eyeees S @ component 
! while the Push Inner Record Address instruction pushes the address of the 

; inner-most record of which the current symbol is a-component. 

L 


ITERAL 
$K_STK_PUSH_OUTER 


OST 48: ! Push Outer Record Address 
DSTS$K_STK_PUSH_INNER_ 


REC = 
REC = ! Push Inner Record Address 


SBLESRENLSSRLSAEANS 


= 


! Define the highest op-code value accepted by the DST Stack Machine. This 
value is used for’ op-code range checking. 


LITERAL 
DSTSK_STK_HIGH = 43; ! Upper bound far range checking 


at a 
fun—o 


! END OF VALUE SPECIFICATION DESCRIPTION, 


HSoseo-1964 3309:08  vaysty ats 


TH e TYPE SPECIFICATION DST RECORD 


fexst.REQ;1 Page 533 


The Type Specification DST record gives the most general data type 
descr ation available in the Debug Symbol Table. It contains the 
name of the data type being described and a OST Type Specification 
that describes the type. The type name is 

data ty es can be named, such as PASCAL. If no type name exists, 
the null name (the name of zero Length? is spect ed in this record. 
DST Type Spec fications are described in deta 

of this definition file. 


Ded eee ee ee 


T 
used in languages where 
in the next section 


Type Specification DST records either immediately follow Separate 
Type Specification DST records or are pointed to by Indirect Type 
Speci Ticet tons or Novel Length Type Specifications elsewhere in 

the DST for the current module. 


This is the format of the Type Specification DST record: 


pees eon ane eseeeceoe See ee eeeeeaneaenee Fee eee eee eeeeoneaeaneae Se eee eee eeeeeneaee + 


byte |} DSTS$B_LENGTH } 


foment oan eww eocer soon aneene =x oe ee Ere San oenrewzeernme ere ee i ee wee wm wee mn a + 
byte 


DSTSB_TYPE (= DSTSK_TYPSPEC) ' 


' 
' 
! 
' 
i 
i 
i 
i 
' foeecae ewroe2wroeroe = Seeeeeeeeeaoenene= eae roe Bee BP ee ew Be ew ee we errr 3rre2erreee— + 
t 
i] 
‘ 
F 


Sa eee ee ett ee ae ee 


byte | DSTSB_TYPSPEC_NAME 


teeooooooesosoosesess eeoeee SSSeS BB OSB es ZnB Bee Bees Be wmr ee mn mre e moe owe = 


var 
The Type Name in ASCII 


(The name’s length is given by DSTSB_TYPSPEC_NAME) 

var DSTSA_TYPSPEC_TS_ADDR 

The DST Type Specification for the 
Data Type being defined 
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Define the fields of the Type Specification DST record. 

IELD DSTSTYPSPEC_FIELDS =~ 
DSTS$B_TYPSPEC_NAME =C€2, 6.1], 
DSTSA_TYPSPEC_TS_ADDR =( 3, A_ ] 
TES; 


BELL LLP PPL PPPS 


ws 
SSIES 


The count byte for the Counted 
ASCII Type N 


ame 
The location of the DST Type 
Specification 
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A DST Type Spent tegt ten specifies the data type of some data symbol. 
zt Type Specificat constitute the most raeres form of as g fyre 
description available in ene nanet Syabos Ta They er e found 
only one kind of DST record, namely the Type Specification DST record. 
However, some Type Specifications contain nested Type Specifications, 
vadeyy qperatss quite complex ait d ase tions. For enate e, the parent 
type for a Subrange data type y a nested Type Specification 
within the Subrange Type Speciticat on. 


This is the general format of all DST Type Specifications: 


A data symbol whose pote type must be described by a DST Type Specifi- 
cation is Coser *bed by ft Separate iy Specification DST record. This 
DST record is immediately followed ype Specification DST record. 
which contains the DST Type Specification for the symbol's data type. 


To conserve DST space when several symbols have the same data type the 

Type Specification that follows the separate Type S$ oct Tteation sf 

record may be an Indirect t pe inter ication. The Indirect Type Speci- 
cation then contains a po 

DST record for the symbol ; eve. ak single copy of a... s actual 


records followed by Type @ spect cat on  } records containing Indirect 

s case, the Indirect Type Specifications 
point to the Secorg Beg n or Fruneret} on Type Begin DST record for the 
on type being specified. 


In epee the © qaty ty ype Specification eff can refer to a record or enum- 
erat ston he “+ re : Type Specif cation. AL Nove’ this tape Type 
Spec ifica an too but “nornal ly used this wer! 
Specificati a s thus used : ith n votner ty pe Speci {ice fons: when eerd 
dl enuperet ten - es must be speci ioe exenp) e, when the element 
ype of an array ; ’ re ecor oo in the A on type, it is speci tied by re 
128 rect + Type Spec : cat on within the acrey ype Specification, S$ : 
i Vo target 79 typed 99! nter is a record or enumeration typ 
objext, A Serge type s speci ¢¢. by an ind rect Type Spec 
hin the Typed Pointer Type Specificat 


icat > 
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' 

' 

' 

' 

' 

' 

| 

' 

| 

' 

' 

' 

' 

| 

' 

' 

' 

' 

: The location 9 the array flags 
: that indicate Type Specs 
for the subscrigt atye* 
' 
' 
' 
' 
' 
' 
' 
' 
! 
' 
' 
' 
' 
' 
i 
' 
i 
‘ 
' 
' 


! H 
; 
1 . 
; Det ine all the fields that can appear in the various Type Specifications. : 
Also define the declaration macro. : 
FIELD DSTSTYPE. SPEC_FIELDS = : 
DSTSW_TS_LENGTH =({0, Ww], ! The ect tfeer of the Type . 
he fication por My lial - H 
this hengeh | : 
DST$SB_TS_KIND = s @. ae The T pe Specification eta : 
DSTSB_TS_ATOM_T = » eae The Atomic data type code ; 
DSTSA_TS_DSC_VSPEC_ADDR = > a ae The VAX descr gtor Value Spec : 
DSTSAcTSci Pr PT = > ten ee Indirect Type Spec DST pointer : 
DSTSA_TS_TPTR_TSPEC_ADDR= e Re Jee yped Pointer parent type Type 3 
Specification location : 
DSTSB_TS_PIC_DLENG = eae byte length of data objects : 
; of this picture type : 
DST$B_TS_PIC_LANG =(€4, 6.1], ! The DST Language code for this Fa 
! picture data type 3 
DSTSB_TS_PIC_PLENG *{ 3. 8. 2. ! The Length of the picture : 
! string in this Type Spec : 
DSTSA_TS_PIC_ADDR =(€ 6, AL], ! The location where the picture 3 
' is encoded in Type Spec ; 
DSTS$B_TS_ARRAY_DIM 5. 8. }: ! The number of array dimensions 3 
DSTS$A_TS “ARRAY “FLAGS _ADDR= 4, A ° ; 
DSTSL_TS_SET_LENG *(€ 3.4. J, ! The Length in : 
; obfe ts a yi Fy set type F 
DSTSA_TS_SET_PAR_TSPEC_ADDR = C 7, A_ J,! The sete on of the Set s : 
: parent Pad Type Spec : 
DSTS$L_TS_SUBR_LENG (3, t. 2. ! The Length in bits of ¢ ects 3 
} of this prongs * =. PF 
DSTSA_TS_SUBR_PAR_TSPEC_ADDR= C 7, A_ J,! Locatjon of the parent : 
! ype Specification ethin : 
} the Subrange ype Spec 
DSTS$B_TS_FILE_LANG ={({ 3, 8 }: ! Language code for type 

DSTSA_TS_FILE_RCRD_TYP = » AL ' Location of Type Spec giving 
; element type for : * 

DSTSA_TS_AREA_BYT = f : AL ]: ' Length in bytes of PL/I ‘‘area’ 
DSTSA_TS_OF FSET YVACSPEC = o, ! Location of Value Spec ‘iare 
} base address o of Pt PL/I area 

DSTSL_TS_NOV_LENG et ds t. de ! The "'no Length ts of 
; novel of this setae type 
DSTSL_TS_NOV_LENG_PAR_TSPEC = C 7, L_ J,! DST pointer. to parent type for 

t ‘novel Length’’ type 
DSTSL_TS_SELF_LENG =(€3,t.] Table length for this array of 
-_ PL/I Self-Relative Labels 


MACRO 
DSTSTYPE_SPEC = BLOCKC, BYTE) FIELD(DSTSTYPE_SPEC_FIELDS) 2%; 


! The following are the values that may appear in the DST$B_TS_KIND field. 


=MN 
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; 84 ! 

; 5 LITERAL 

; 8 DSTSK_TS_DTYPE_LOWEST = 1, | ---Lowest Uy Spec kind 

3 DSTSK_TS_ATOM = 1, } prenie Type oe 

; 8 DSTSK_TS_DSC - ¢° ! VAX Standard ce Type Spec 

3 89 DSTSK_TS_IND = 3, ! Indirect inype ec 

; 590 DSTSK_TS_TPTR = 4, ! Typed Pointer <iype Spec 

; 591 DSTSK_TS_PTR = 5, ! Pointer Type S$ 

3 236 DSTSK_TS_PIC = g. ! Pictured ype pec 

3 3 DSTSK_TS_ARRAY = 7, ' Array Type Spec 

3 94 DSTSK_TS_SET = 8, ! Set Type Spec 

; 23? DSTSK_TS_SUBRANGE = 9 ! Subrange Type Bese 

; 96 1 = 16, | Unused=-available for future use 

3 597 DSTSK_TS_FILE = 11, ! File Type Spec 

; 598 DSTSK_TS_AREA = \¢- ! Area Type Spec (PL/I) 

3 599 0 DSTSK_TS_OFFSET = 135, ! Offset ype Spec (PL/I) 

H 600 0 DSTSK_TS_NOV_LENG = 14, ! Novel Length yp pe Spec 

3 601 8 DSTSK_TS_IND_TSPEC ew, } ats Mt og ee rh generated pointer to 
3 60 } e cannot appear in DST) 
3 6035 0 DSTSK_TS_SELF_REL_LABEL = 16, ! Selt-Re tetee® Label Type Spec (PL/I) 
3 604 0 DSTSK_TS_REA = 17, ' Record File Address Type Spec (BASIC) 
: 605 0 DSTSK_TS_TASK = 18, ! Task Type Spec (ADA) 

3 O88 8 DST$K_TS_DTYPE_HIGHEST = 18; ! -=-Highest Type Spec “kind 

: 2608 0 

3 609 0 ! The following set of Literals give the pengthe in bytes of those Type 

; 219 8 Specifications which have a fixed length. 

; olg 0 LITERAL 

; 613 0 DSTSK_TS_ATOM_LENG = 4, ' Atomic Type Spec length 

3 614 0 DST$K_TS_IND_CENG = 7, ! Indirect Type Spec Length 

: 615 0 DSTSK_TS_PTR_LENG = 3, ' Pointer Type Spec length 

; 616 0 DSTSK_TS_FILE_LENG = 4, ! File Type Spec length 

3 617 0 DST$K_TS_AREA_ LENG = 3, ' Area Type Spec Length 

3 618 0 DSTSK_TS “OFFSET LENG z7 ! Offset Type Spec Length 

: 619 0 DST$K-TS-NOV_LENG LENG = 11, Novel Length ype Spec Length 

; 2620 0 DST$K_TS_TASR_LENG = 3; ! Task Type Spec leng 


De Se Be Oe Oe Se Be Be Be Be BH SH Oe Be Oe Oe Se Be Se SHS SS Oe HH Oe Oe Oe Os He BOs Os Oe OHH Oe Oe Oe Bs Os SHOE SH Bees 
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ATOMIC TYPE SPECIFICATIONS 


The Atomic Types ecification is used to describe an atomic VAX standard 


3 


6 

6 

6 

é 

6 data type. ype Specification consists of the standard Type Speci- 
6 fication header followec by as ngte byte centeining the VAX standard 

6 data type coce (one of the DSC$K_OTYPE_x codes). The Atomic Type Speci- 
; fication has the following format: 

6 teeceee-- eon eeeee eee wee ween w eee e ewww ene nne wee e renee nee eneeee + 

? word H DSTSW_TS_LENGTH (= 2) ! 

byte | DSTSB_TS_KIND (= DSTSK_TS_ATOM) H 

> byte | DST$B_TS_ATOM_TYP H 

6 


DESCRIPTOR TYPE SPECIFICATIONS 


POPIPIPOPIPIPINININIPIPIPIPININIPINIPINIPYNPPYNOPD 
re SSSSSS5 
WR SO ODONOUE AN“ OOONOU Ewin 


CGOOCCOCOCOCOCOOOSOSSSOCSSOOOSCOOCOCCOOOOOOOOOCOOOCOOOCOOO 


Cd ed ee eed ee eee 


4 

5 

6 The Descriptor Type Specification is used for VAX Standard Data Types 

7 that can be described by VAX Standard Descriptors but cannot be de- 
648 scribed by an atomic type code. Packed decimal, which requires a 
649 digit length and a scale factor, and ASCII text, which requires a 
650 gtr ing length, are examples of such data types. The Descriptor Type 
651 Specification contains a Value Specification which must produce a 
$36 VAX Standard Descriptor. This is the format: 
654 
655 Se oe eames eccee eaewoceer ese este ne eee eee neers + 
$26 word H DST$W_TS_LENGTH H 
$38 byte H DSTSB_TS_KIND (= DSTSK_TS_DSC) H 
ree var} DSTSA_TS_DSC_VSPEC_ADDR 
666 Value Specification Yielding a VAX Standard Descriptor 
664 
665 pee e ne I wee es m ee eee eee eee ee + 


POPONIPOPINIPININININOPUPoPoNnoNoNoNoNgNny) 


Pee Se ee Se Se Se Be FHS Se Se Se Se Se SH Se SH Se Se Se Se Se Se Se ee Se Oe Be Se FH OH Se OH Ob Os Oe Oe Se Oe Se HOES Se we 


Ss 


OCOOOCOCCCOCOCCOCOCCOOCOCOCOCOCOOOCoOOOoOo 


PAAAAAAAOSO 
SSS. 


CONAOULSWr OO 


word 
byte 
Long 


INDIRECT TYPE SPECIFICATIONS 


} ; :09: 
18-$¢p-1986 92:50:56 


vanstt BL 


i -0-74 Pp 
"$255$DUA2 Caeifexost.rea;1 9st 


The Indirect Type Specification is used when the actual Type Specifica- 


tion desired is found in another DS 
contains a DST pointer which points 


T record. This Type Spec 
to that other DST record 


abs To 


€ 
pointer contains the byte offset td bg to the start of the whole DST 


of the DST record that gives the ac 


- to DST record must be one of three 
fication DST record, a Record Begin DST record, or an Enumerat 
The Indirect type Specification is the only 


Begin DST record. 


type nformation. T 
0 


rye 
kinds DST records: a T 


he pointed- 

ype Speci- 
on Type 
Type 


Specification that cam refer to a record or enumeration type; those 


tyges are too complex (potent bh! 
This is the format of the Indirec 


to be referred to any ot 
Type Specification: 


her way. 


tee reces weet eee te meee ew meer emer em ene CeO ee ne meee ewes e eee + 
i DST$W_TS_LENGTH (= 5) i 
i DST$B_TS_KIND (= DSTSK_TS_IND) i 
DSTSL_TS_IND_PTR 

$m em meme eee eee em ew ee ww ee ee ew meee em eee eee wet mete eee eee eee + 


Se a ee 


. 
. 
” 
. 
. 
. 
. 
o 
. 
eo 
- 
a 
. 
e 
. 
: 
. 
° 
- 
. 
. 
. 
. 
a 
. 
oe 
. 
. 
. 
2 
. 
. 
. 
e 
~ 
. 
7 
* 
. 
o 
. 
2 
7 
- 
. 
. 
. 
o 


Nam nescence ia Rn a il a aa i at em rma icon detail oe aaa ne — 


. 
Se fe te tee Bi in Bite in Din itn Btn tn Sy in et te te te be be ee be bee” be | 


PITIPIPIPIPIPIRD — — 2 2 2 2 


WN 9 OONO UE WN "OC OONOUS WN —O” 


uw 


CGOOOOOOOOSOOSOSOSSOSSSSOSSCSOCCOOOOCOOOOOCOOOOOOOOOOOCOO 


word 
byte 
var 


word 
byte 


— sn 
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TYPED POINTER TYPE SPECIFICATIONS 


The Typed Pointer Type Specification describes a typed pointer data 
ype, moaning a pointer to a specific other data type. Pointer-to- 
res as found in PASCAL and other La guages . S an example of a 

$ 


typed pointer type. In this example, integer the ‘parent type’ 
This Type Specification contains oe enbedded Type Speci ti ation waich 
specifies the nter type. This is the 


arent type for the typed po 
tree Pointer Type Spore tice 


format of the ation: 

DSTSW_TS_LENGTH ' 

' DSTSB_TS_KIND (= DSTSK_TS_TPTR) ' 
DSTSA_TS_TPTR_TSPEC_ADDR 

Type Specification for Parent Type that 


Objects of Typed Pointer Type Point to 


} oe weccccccccos } 


+ 
f 
' 
‘ 
i 
4 
i 
‘ 
F] 
i 
J 
i 
i 
iy 
t 
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‘ 
‘ 
' 
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7 
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ft 
u 
7 
t 
a 
oy 
‘ 
' 
a 
‘ 
v 
q 
t 
a 
’ 
f 
a 
4 
4 
t 
t 
t 
a 
iy 
‘ 
' 
‘ 
a 
a 
A 
a 
‘ 
t 
6 
‘ 
' 
‘ 
a 
p 


POINTER TYPE SPECIFICATIONS 


The Pointer Type Specification is used for pointer types which are not 
typed, meaning that the type of object that the pointer points to is 
not known at compile-time. PL/I pesasers are examples of this kind of 
pointer type. Since there is no known parent type, none is spec ified 
in this Type Specification. The Pointer Type Specification thus has 
the simplest possible format: 


Pee Se Se Fe Se Oe Be SH Se Oe we Be Os Oe Se Oe Oe Se Oe Os Se Be Oe Be Oe Oe OHS Os Se Oe Oe Oe OHS Oe we 


few ee eee ee ee Pe Be Se OB ew ee He Oe MR mE HB em Me BOB Ee Oe mH BB TOE BO Eee Oe eee + 


DST$W_TS_LENGTH (= 1) 


eee eeces Sere sre tre ros etme ene et ee we ew Oe Te eB Oe DO Pom eare erm e emer ee nr ene + 


DSTSB_TS_KIND (= DST$K.1S_PTR) 


cen oe Petree eee ew ee mem ew ew eR SOO Se Re HE De ER OH we eH HOMME Sem wm Bee HE Re ee HY 


: aherseaaiee 
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PICTURE TYPE SPECIFICATIONS 


~~ 
NOUS WN OOO~ 


The Picture A ohh Specification is used for picture dete types as found 


SANS 
ae 


in COBOL and Because the yt pepens ice of t ture data types 
vary between Languages th Tyee $e cification con a ve the Language 
code assoc i thi is : ecific picture type.. It also contains the 


—~ 
= 
uw 


byte bength of obj ec Fictp iB, .. @ picture type. an enco ding of ¢ the picture. 


DST$B_TS 7h iC DLENG field contains the Length in bytes of each data 
shletk of of’ this picture type. DEBUG assumes that picture objects are 
represented internally as ASCII character strings. 


The Language code in the DST$B_TS_PIC_LANG field is the same as that 
used in the Module Begin DST récofd. ~ 


The DST$8_TS_PIC_PLENG field yes he Ps Length of the picture , 
soegging fe In the BST$A_TS alt, DOR f The p gture encoding in the 
PIC_ADDR fieTd Consists of . : equence of words. e high- 
order byte of each word contains an unsigned repetition Sorte and 
the low-order byte contains the ASCII gS Ses on of the repeated 
picture character. Hence the * picture 37 s rgpregented. by t 
sequence of byte values: he same 


74 and a lLanguage-spec re encoding (usual ly the EDITPC pattern :. 
74 string). The actual data objects of the picture data type are assumed ; 
i to be represented as ASCII ¢ oracter sarthes. ; 
P20 This is the format of the Picture Type Specification: ; 
7 ; 
ag Govehvonncnbanquatindnilies cnciniginieteentniaieiiitemnsens enone 
et} word H DSTSW_TS_LENGTH H : 

eoeeweneee ies 3 
£38 byte H DSTSB_TS_KIND (= DSTSK_TS_PIC) ! : 
758 byte | DST$B_TS_PIC_DLENG ; 
759 te----- o--------- es ne wies------------ o------------- : ’ 
760 byte ! DST$B_ TS. -PIC LANG H : 
761 teweeeeonecenn- emer rece eee sees ewes ec eee eceeecnne= eoeeeeceece= + : 
iS byte H DST$B_ TS. PIC -PLENG H ; 

eee e eee w ewww ewww een e ewww es ees e nese ee weneenee ey 3 
7 var} DSTSA_TS_PIC_ADOR : 
706 Picture String Encoding ; 
76 ; 
7 teewecoronn- meme e neem renee nn cee n ene w ene e eee e esses esesses= + : 
770 var } H : 
a4 Value Specification Yielding a : 
Ag Language-Specific Encoding of Picture Semantics : 
775 : ; 
77 Heme m ne wen wren ween ene enneene Peer ewe nee e en eee een ene enee= ’ 3 


Be Se Se Se Se Be Be Se Ge Fe Se Ge Ge Fe Se Se Se Ge Se Ge Se Se Fe Se Se Se Se Se Se Ge Se Se Ge Se Se Ge Se Ge Se Se BH Se Se SF Se Se Oe Se Oe Se Ge Ge FHS Se ees 
i 
OOo 
w 
SGOOOOCOOOOOCOCOOCOOSOSOSOSOSOSOSOOOSSOSSOSOSOSOOSOOSOOSCCOOOSOOOCSOOOOOCOOOOOOOOOCO 
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picture can be written as °'S(3)9.(2)9"'.) 


The thon yi Value yo bbe) a the end of the Pict ture nite Speci- 
fication yields the address DITPC +) sate™ ptr at erforms 
the encod} ng psees ated w th: th ; ‘> cture type. 2 ys 7 *thts potrere 
string with the coitey in ineteur Sten when doing D Posi ate sgbjects of 


this grcture ¢ type. the Val “" Specifi cetien © gare ted. can 
only deposit character st strings into such objects sin t ace not know 
how to encode numeric values. 
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ARRAY TYPE SPECIFICATIONS 


The Array Type Spe peveot ten s oe tt see, an Array data type. This speci- ° 
fication a? be gu re . - op ecause 15 not only spec o the Snape of 

each array of this type so eopec' ‘95 bs cerreapens ng element 

data type and HY be su eeut gate types me fype and the types 

of the subscripts are given by additional — f cations nested 

within the Array Type Specif tat on. 


This is the format of the Array Type Specification: 


word | DSTSW_TS_LENGTH i 


byte i DSTSB_TS_KIND (= DSTSK_TS_ARRAY) 


$0666 99 0608008508888 SSSSSSCOCSSSSOEOSNSSESTOOROESOOCOCOCOESCOCCCSS 


Syne T cincaneneciennntinesin Sees le eviliammiiantiahtanntignnes 

var =} DSTSA_TS_ARRAY_FLAGS_ADDR 

Bit Vector of Flags Indicating What Type 
Specifications are Given Below 


(The vector's bit Length is given by DST$B_TS_ARRAY_DIM) 


i De ed ed ed 


DOONOVNLS WN" OVOOnNOus 


ee ee cece cccccccccs > << } <= 


SOSA Pe eee 


var , H 
Value Specification Producing an Array Descriptor ' 


var 
Optional Type Specification for Array Element Data Type 


var ; 
Optional Type Specification for First Subscript Data Type 


var 
More Optional Type Specifications for Subscript Data Types 


} eocccccocccn } cocccccn } cocccccs } cocece } cocccccccccecccs 


D> ee ew www oewn } co eoweon } cece eee= > 


DONO UNE WO OOM WN Oo 


Here the DST$B_TS_ARRAY_DIM field Ry ves the number of dimensions of this 
array type. Néxt, DSTSA_TS_ARRAY_FLAGS_ADDR gives the location of a 


22225 2252 3 


020900 09 C0 Co CD CD CD CD CD CD 
CONAN NNN 
MEW OONOUSWN—O 


So Se 000 


= 


See 


ooo 


02.0909 09 09 CD Co: 
oo 


SSSREASZ 


@ 
=] 


ooooe 


. 
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pitever ter which indicates of nested Ty ‘ Specifications are found 
later in this Array Type Specification. bit 0 is set, a nested Type 
Specification is included for the orcey element f pe (the cell type). 
After Frat, if bit n is set, a nested ype Speci Gat on for the n-th 
qecr pi} type is included in this Array Type Specification. I | bit 
n th t-vector is zero (not set), the gore pond "9 Type pose’ ica- 
tion $ onisteg from the Array Type Specification. If the e quent type 
specif cation S omitted, fhe element type $ assumed to be given by the 
array descriptor's DTYPE field. If a subser pt type specificat 5 
omitted, the subscript type 3 secuned to be longword integer (DTYPE_L). 
(Subscript Type Specifications are mainly needed for enumeration type 
subscripts as allowed in PASCAL.) 


The number of bits in the bit-vector is DST$B_TS_ARRAY_DIM plus one more 
for the element type. The whole DSTSA_TS_ARRAY_FLAGS_ADDR field is of 
course rounded up to the nearest byte. Boundary. 


The array descriptor Value Specification that follows the bit-vector 
field produces a VAX Standard Descriptor for the array: (The seeerieter 
class must be DSCSK_CLASS_A, DSCSK_CLASS_NCA, or DSCSK_CLASS_UBA.) This 
array descriptor gives the strides (or multipliers) and the Tower and 
upper bounds for all of the array dimensions. It also gives the element 
data type, anc tud ing its scale factor, digit count, or other type infor- 
mation as appropriate. However, the descriptor's element type can be 
overridden Y an element iyee Specification as noted above; in this case 
the DSCSB_DTYPE field of the descriptor should be zero. 


The Array Type Specification is normally only used in two situations. 
First, it is used if the array fype does not have a compile-time-con- 
stant descriptor (for qxanpie. i t has variable array bounds) and no 
run-time descriptor exists in the user's address space. Second, it is 
used if the arrey type cannot be-described a VAX Standard Descriptor, 
either because the element type gennet be described by a VAX Standard 
Descriptor or because the subscript types are not integers. (Element 
types such as records, enumeration types, and typed pointers cannot be 
described by VAX Stenger? Descriptors.) if neither of these situations 
pertains, there ares apier ways of describing array types in the DST ' 
using Standard Data or Descriptor Format DST records. 


: 
; 
; 
: 
: 
; 
; 


Sea 


3 
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a dD 
NOUS WOOO 
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SET TYPE SPECIFICATIONS 


The Set Type Specification specifies a Set data type as in PASCAL. A 
Set type a ways has a parent data type. For.the set-of-integers type 
for example, integer is the parent type. The parent type must be either 
integer, some enumeration type, or a ouarenge of those types: DEBUG 
assumes that the Set type is represented internally as a bit-string 
where a given bit is set if and only if the corresponding i 
enumeration type element is ; eyaver of the set. The n-th b 
bit-str ng (starting at bit 0) is assumed to correspond to the n-th 
element of the parent type. The length of the bit-string is part of 
the Set type and is specified in the Set Type Specification. 


This is the format of the Set Type Specification: 


peocmoceawoneecesanes eeeee Ses wecee= ea = See Bee eee ese senses ce eet eee eaa +} 


} DSTS$W_TS_LENGTH 


eae moms mensanensanzreecceaeeas eseeee Sec sew ner ae eee ee wao wenreoeee wee eee woe td 


; DSTSB_TS_KIND (= DSTSK_TS_SET) 


deme sceesce Seeeee meme erwrerwreren wr eovwwereere2rocor eee eee ew wm eae = ee eeoeaaneaoeaoe ema mae + 


H DSTSL_TS_SET_LENG i 


domme meamemnnoenoscane eSeeoeeoee@ SSS OSS SSS SSS eoeaneaan won eoo a} 


DSTSA_TS_SET_PAR_TSPEC_ADDR ! 
Type Specification Specifying the Set's Parent Type 


> on ww wn nee 


ee2eoeeaoeoeoeoe eSenreronwrerrwraeereewweece = Sew nee tr ere ens eer ee ee oe ae Laon ew er wre ere wee = + 


Here the DSTSL_TS_SET_LENG field gives the bit length of an object of 
the Set data tYpe. DSTSA_TS_SET_PAR_TSPEC_ADDR marks the location of 
an embedded DST Type Specification for ye parent type of the Set type. 
Typically this is an Atomic Type Specification for type integer, an 
Indirect Type Specification that points to an Enumeration Type Begin 
DST record, or a Subrange Type Specification. 
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PPADS E™ £~ & 


OWONAOVLS WN "OVO ONOULWN—O0OW 


SSSESSSTERES 


SOOOCSOSOSOOCOOOOSOSSOOSOSOSSSSOSSOSOSOOOOOOOCOOOOOOOOOOOOOCOO 


978 


word 
byte 
long 
var 


var 


var 
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SUBRANGE TYPE SPECIFICATIONS 


The Subrange Type Specification describes a Subrange data type 
3a guerenge of ; me ordina type such as integer or an enumerat 
This { cifies the parent type (the original 


Type Specification spe 
type} and t ¢ ower and Mpeer bounds of the su 
bit length o objects of the 
Subrange Type Specification: 


DSTSW_TS_LENGTH . 
DSTSB_TS_KIND (= DSTSK_TS_SUBRANGE) 

! DSTSL_TS_SUBR_LENG 
DSTSA_TS_SUBR_PAR_TSPEC_ADDR 

Type Specification Specifying the Subrange’s Parent Type 
tonwcccennnenee ee See oe ee ee ae ee Se Sm ee eee ne Se Se eee oe ww Oe = eee 
Value Specification Giving the Lower Bound of the Subrange 

: ce ee te ee oe ee ce we Se ee ee ee ee Se > oe oo ne ee a ee a on ee Daw me os oe ee 
Value Specification Giving the Upper Bound of the Subrange 

e Se ee e2eeee eee eeoeoeoeeo @eeeoeeoe Seeee ee e222 e2eeeeeeeneene se eoeeonenee Renee - 


Here the DSTSL_TS_SUBR_LENG field gives the Length in bits of 
of the Subrange data type. DSTSA_TS_SUBR_PAR_TSPEC_ADDR mark 


location of a DST Type pecification for the harent type of the a bee 
e inte 
ype Begin 


range. Typical ty t is an Aponte Type Specification for ty 
oc on inet rest Type Specification pointing to an Enumeration 
record. 


The two Value Specifications in this Type Specification specify the 
lower and upeer bounds of the subrange. These bounds values must be 
e 


values of the parent type. 


Oe ee ee ee ee 


Vays! 


meaning 
nt 


range. It also gives the 
Subrange type. This is the format of the 


objects 
s the 
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FILE TYPE SPECIFICATIONS 


The File "eps Specification wag jb a File data t type ae syne se 
PASCAL or PL/I, for example. nce the interpretation of F types 
pornos from language to language, she L nguage ceee if for is Fe File 

type | s included in the Ty pe ppect icat Qn ptionally, a file recerd 
Type Specification on gan. be Voc uses speci fying the type of a record in 
t L File-of-Reals, for instance, vould have Real 
(F-Floating) as je tile record type. 


This is the format of the File Type Specification: 


Pwr 


prstiastearirey 


SOOOSOSCOSOSOSOSCSOOCSOSOSOOOOOOOOOOO OOOO OOOOOO 


Od ee eed tee 


$ rem mmm meme ween ewww wee w wow ec ewe eee ew eee ee eee ceeceeceoeeccceceen= + 

Oog word |} DST$W_TS LENGTH ' 

00 ahaa eee ariel ecieieeneerheeenebeteaaeteneeietateneetatetaeteeatel + 

bbe byte H DSTSB_TS_KIND (= DSTS$K 1S FILE) H 

Boe shes EE eA Oe ; 

Boe var 3 DSTSA_TS_FILE_RCRD_TYP 

3010 Type Specification Giving the File Record Type 

3018 

01 Hamer w ewe enw e ewww new wn eee wn ee ne ee cece eee nse eeeeseessesssese= + 

014 

aE 

O19 Here the DSTSB_TS_FILE_LANG field contains the zen uage code for this 
018 le. The same Language codes are used as in the meth Begin DST 
$045 record. *DSTSA_TS_FILE eh CRD. TYP is the location of a D Type e Specifi- 
020 cation for the record type. “if applicable. This Type aa fication is 
3021 cpt ional: if omitted, file-of-characters is assumed. 
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AREA TYPE SPECIFICATIONS 


NOTE: THIS TYPE SPECIFICATION IS NOT SUPPORTED BY DEBUG V4.0. 


The Area Type Specification describes a PL/I ‘‘area'' type. PL/I areas 
are regions of memory whose base addresses are determined at run-time. 
Areas are always used in conjunction with PL/I] Offsets (see below). 
This is the format of the Area Type Specification: 


poem meen eee seer e eee een ce ee mee meee m ocean eeeeeceoece wee wom ere ewe eee + 

word } DSTSW_TS_LENGTH H 
Sem eeeeeeeeoe cee eee eeeeeeeseeee ee ee cesses eeseecoeesoeseseoececes + 

byte | DSTSB_TS_KIND (= DSTSK_TS_AREA) H 
var} DSTSA_TS_AREA_BYTE_LEN 
Value Specification Giving the Area Byte Length 

(oo nenaceumerensrssouuesunsssnreseressessecaisssquenssesasnasse + 


Here the DSTSA_TS_AREA_BYTE_LEN Value Specification specifies the byte 
Length of the PL/T Area. 
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word 
byte 


< 
Oo 
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var 


OFFSET TYPE SPECIFICATIONS 


NOTE: THIS TYPE SPECIFICATION IS NOT SUPPORTED BY DEBUG V4.0. 


The Offset Type Specification describes a PL/I ‘‘offset’’ type. PL/I 
offsets are offsets relative to the start of a PL/I ‘‘area’’ (see above), 
a dynamically allocated region of memory. The Offset Type Spec it ica= 
tion specifies the base address of the associated area and the byte 
offset value of this offset type. This is the format: 


ae eee ewe eeeeeee een eran wre wer ere ee ee see mee SSS eee enenanenee + 


i DSTSW_TS_LENGTH ' 


$e eee wm enero eenceone sSeeoeeee SeSSSeeseoncesosseceqeuuaasqounane eseeceoe > 


i DSTSB_TS_KIND (= DSTSK_TS_OFFSET) H 
DSTSA_TS_OFFSET_VALSPEC 
Valve Specification Giving the Base Address 


of the Area Associated with this Offset 


Value Specification Giving the Byte Offset Value 


} ececccce } ec cccccccccccs 
g 
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Here the DSTSA_TS_OFFSET_VALSPEC Value Specification produces the base 
address of the asSociated area and the second Value Specification gives 
the byte offset value into the area. : 
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NOVEL LENGTH TYPE SPECIFICATIONS 


The Novel henge Type Specification is used to spect! ~~ data type 
that is identical to a parent data type except that the objects of this 
new type have a different length (a “novel” or atyeice: ength). This 
rype vag bE cation is used for the components of PACKED records in 
PASCAL, for example. A pg Pee component of a peckse record consists 

of a single bit (the novel length) while all other booleans consist of 

a byte (the normal Leng h). To describe the pecned boolean type, a 
Novel Length "yee Spec seas tay is used which specifies the novel length 
and points to the DST description of the parent type, namely the normal 
boolean Sype. DEBUG accessed objects of a Novel-Length type by expand- 
ing them to the normal Length for that type. 


This is the format of the Novel Length Type Specification: 


Bord a cecncenn nese DSTOMTS LENGTH (29) 
wT Scene 2 thea rte Miele bine baa an emanadtt Rete! 2 : 
ele manbeaion che SA et mn Mee oceanaaaadie ; 
We.  jalieisiingsiambigiibeeeeenetee Meet aiiasduniaiaeia i 


Here the DSTSL_TS_NOV_LENG field contains the ‘'novel"’ Length of this 
data type. The DST$L_TS_NOV_LENG_PAR_TSPEC field is a DST pointer which 
contains the byte offSet relative to the start of the whole DST of the 
DST record that specifies the perens type. The pointed-to DST record 
must be a Type Specification DST record, a Record Begin DST record, or 
an Enumeration Type Begin DST record. (Typically it is a Type Specifi- 
cation DST record containing an Atomic Type Specification for type inte- 
ger or boolean or an Enumeration Type Begin DST record.) 


HScdeoct9pe 25:09:08 vaRedy Bites: 


V4.0-742 Page 72 
CE.SRCITBKDST.REQ;1 (44) 


; } 5 SELF=RELATIVE LABEL TYPE SPECIFICATIONS ; 
: : 
; 1 3 The Self-Relative Label Type Specification specifies the type of a PL/I : 
: 130 ! “self-relative’’ Label. Such a label is petuatty, 4a wr array. meaning : 
; 131 ' that it must be indexed by an "18 eger value to yield a specific label ; 
: 1 ¢ ! value. The internal representation consists of an array of longwords ; 
; 1 ! where each array element contains a label value relative to the start of : 
3 134 : the og Mak ng the element values relative to the giact of the array ‘ 
3 : 5 ensures that the label array is Position-Independent (PIC). ‘ 
$ : 3 
3 1 ? This is the format of the Self-Relative Label Type Specification: : 
: i : 
: 18 0 i fw ween erences eet tt ee tee meee mem en meme ewe mew en eee nwo emo eee eae ooe + ° 
3 V2) } word H DSTSW_ TS _LENGTH (= 1) H : 
: 148 byte | DSTSB_TS_KIND (= DSTSK_ TS_SELF “REL LABEL) \ 

; 145 5 

2s 

> 3149 5 i TASK TYPE SPECIFICATIONS ‘ 

; 150 0 ! 

So 

: 138 ! NOTE: THIS TYPE SPECIFICATION IS NOT SUPPORTED BY DEBUG V4.0. 

; 155 i The Task Type foes trices ten specifies the data type of task objects 

: 156 ! as found in ADA. Objects of the Task data type v assumed to have 

3 157 ! longword values understood by the ADA multi-tasking kernel. Since 

: 158 ! no additional information is associated with the Task data type, the 

3 12 } Task Type Specification has the minimal format: 

; 161 0 ; : P 

Biv, 188 0 i word | DSTS$W_TS_LENGTH (= 1) 

; 164 ' Ne ee eo + 

3 165 0 ! byte |} DST$B_TS _KIND_ (= DST$K_TS_TASK) } 

2 166 0 te He MONE eB OTe EOE EE BOSE BE SO HD ee EH Oe HE eB eee Ee eR ee HH ee + 

: 167 ! 

Hee 

: 170 0 i END OF. TYPE SPECIFICATION DESCRIPTION. 
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ENUMERATION TYPE DST RECORDS 


Enumeration types. as found in PASCAL and C, are represented in the 
DST by three kinds of DST records. The Enumeration ree Begin DST 
record describes the type itself, giving the bit length of objects 

of that type and the name of the type (e.g., COLOR). This record 

is followed by some number of Enumeration Type Element DST records, 
one for each element, or literal, in the type (e.g.. RED, BLUE, and 
GREEN). Each Enumeration Type Element DST record gives the name and 
numeric a | of one Literal of the enumeration type. The whole type 
description is then terminated by an Enumeration Type End DST record. 


The Enumeration Type Begin and Enumeration Type nd DST records thus 
argent) the List of elements of the type, much Like other peg inagne 
pairs in the DST. The Enumeration Type Etenent DST records within 
those brackets do not have to be in numeric order of their values, 
although it is desirable if they are. For languages like ADA, where 
the numeric values of the elements need not co up sequentially with 
the Logical element positions, the Enumeration Type DST Elements do 
have to be order of their logical positions, however. No other kinds 
of DST records (except Continuation DST records) may appear between 
the Enumeration Type Begin and the Enumeration Type End DST records. 
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THE ENUMERATION TYPE BEGIN DST RECORD 


The Eouneret ton Type Begin DST record specifies the name of an 
on type and the bit Length of objects of shat type. 
st of Enumeration 
Type Element DST records, and must_be matched by a § osing 
Enumeration Type End DST record. This is record's format: 


It also serves as the opening bracket for a | 


See eeeceeceeeeeeeeeeeeeeeeeeeeeeeeseeeeeesesesn eeecee Semen mn en moans $+ 


ait Ce oe insist rantlee ptpdoccennibinneunnaeiansia 
me 5 chime SecrMicestunet redler one sismiadinnsibiaan ; 
byte i DSTSB_ENUMBEG_LENG ' 
5 Fi dieninniie PIA OOO Ln aes +5 noce. SOP canna 
var 


The Name of the Enumeration Type in ASCII 
(The name's Length is given by DST$B_ENUMBEG_NAME) 


Define the fields of the Enumeration Type Begin DST record. 
IELD DSTSENUMBEG_FIELDS = 


' 
' $ucae eSeeee eee eeeeane SSS SS SSS SSS SSS ennennee won tana een ewe oewea 
| 
' 
i 
F 


DST$B_ENUMBEG_LENG =C€ 2, 8.1], ! Bit Longgh of data objects of 

} this enumeration type 
DST$B_ENUMBEG_NAME sth & 2 ' Count byte for the Counted 
res ! ASCII Type Name 
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THE ENUMERATION TYPE ELEMENT DST RECORD 


The Enumeration Type Tenant DST record specifies the name and value 


of one element (one Literal) of an enumeration type. It may only 


pegeer between an Enunerat on Type Begin and an Enumer tion. Type End 


record. The oot hes 


assumed to be unsigned ger. 4g by ayELacs field in 


ng representation of enumeration types is aa 
rec 


has its normal Anterpretetion loop” Ae Data DST record for 


the details) re nce the DST$V_VALKIND ed. 7 Ll have the value 
DSTSK *yALKING LITERAL and the BSTSL_VALUE field 
priaté integer value in this case. 


This is the format of the Enumeration Type Element DST record: 


$e wm nen eres een eee ane = eo eee = ee eseuenceoeeeeeosesese oe Se ot ee oe ee eeeeoou st 
byte H DSTSB_LENGTH H 
byte i DSTSB_TYPE (= DSTSK_ENUMELT) H 
byte ! DSTSB_VFLAGS ! 
long H DSTSL -VALUE ' 
byte | DST$B NAME H 
germ em mn tee me mew ee eee eee eee ee ee ee ee ee ew ee meme ee mee ee wee rere ter eee + 
var ' ' 
The Name of the Enumeration Literal in ASCII ‘ 
(The name's length is given by DSTSB_NAME) 
e eeeeeecoeeoeoen em SS EB See De OS Oe Seeeeoeeeeeecoees Se eeeeoeeeoeeeeee > 


THE ENUMERATION TYPE END DST RECORD 


will have the appro- 


7 

7 
3 The Enumeration Type End DST record terminates the description of an 
enumeration type. This is the record's format: 

7 

78 ¢eeco remem e eer moce semen ee weir awa r ones eseaeasse Sete nse enw ec eee eee oS ee + 

A byte H DSTSB_ LENGTH H 

30 byte DSTSB_ TYPE (= _DSTSK — ENUMEND) H 

peewoen sen eae sre cocuscanmee one SSS S SSS SSSSeSSSSSSSSeSeeeeeeeoeeeoeen 2eece 
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RECORD STRUCTURE DST RECORDS 


ME Wwry 


Record structures, or simply records, refer to the aggregates of non- 
homogeneous components found in many ! nguages In some languages, 
such constructs are called “records n PA SAL and COBOL, for example) 
and in others they are called ‘'structures' (in PL/I, for example). 

Here we will call them “records”. What all records have in common is 
that fhey consist of a set of named components, each corresponding to 
some field in the record structure. The components can in general be 
of any data types supported by the Language. 


In the a fyaeet Table, a record is represented by a Record Begin 
DST record followed by some number of data object DST records, one for 
ae record component, followed by a Record End DST record. Any data 
object DST record within a Record=Begin/Record-End pair is taken to 
denote a component of that enclosing record epec i ticetion. Other DST 
records may also appear between the Record-Begin/Record-End pair, such 
as Type Specification and other DST records that specify the data types 
of t : components. However, only data DST records denote record com- 
ponents. 


GRENSS SSSR ESSE 


Nested records are defined by record components which are themselves 
records. The type of a record component which is itself a record is 
defined by another Record-Begin/Record-End pair of DST records. This 
additional record definition may appear inside the original record 
definition, but does not have to do so--an Indirect Type Specification 
potas ing to a record definition outside the original record definition 
s also legal. Conversely, a record definition inside another record 
definition does not define a nested record unless some component of 
the outer record actually references the inner record definition. In 
short, the DST can only describe one level of record components at a 
time, but any component can be of any arbitrary deta type including 
another record type. 


ve 
oOo 
oo 


The Record Begin DST record is unusual in that it can define both a 
data type and a data object. If the DST$B VFLAGS field has the special 
TSK_VFLAGS_NOVAL, then the Secore Begin DST record defines an 

abstract data type. oon | object of this data type must be represented 
fication DST record which immediately precedes 

her the Record Begin OST record or a Type S$ oc 1Ficatton DST record 
that contains an Ind rest Type Specification that points to the Record 
Begin DST record. In this case, the name in the Record Begin record is 
taken to be the name of the data type, not of any object of that type. 


However, if the DSTSB_VFLAGS field does not contain DSTSK_VFLAGS_NOVAL, 
then the Record Begin DST record defines both a data type and a data 
object of that type. This form can be useq for languages such as COBOL 
which do not have named data types. In this case, the DSTSB_VFLAGS and 
DSTSL_VALUE fields speci y the address of the record +4 eft Tn the same 
way as in the Standard Data DST record. It is still legal to have 
Indirect Type Specifications pointing to this Record Begin DST record, 
using it strictly as a type definition. 


Some Languages. su h as PASCAL allow record variants. (In ADA, the 
same concept is called ‘discriminated’ records.) An object of a record 


SEuenluNoos 
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type with variants contains pone set of components found in all objects 


Frat type plus some set o Components that vary from one vecere 
a -— 0 the next. Which of the varying components are actualy 
of a ‘'ta 


t_in a given record may be determined by the value 9 
variable’ which is a xed ponpeneny of the record. Variants may also 
be nested so that variants have variants. 


In the DST, record variants are described by Variant Set Begin DST 
records, Variant Value DST records, and Var one Set End DST records. 
The Variant Set Begin DST record marks the beginning of a set of record 
vor tents. where each variant consists of some set of record components. 
the Variant Set Begin DST record ind cotes which record component gene 
stitutes the tag variable that discriminates between the variants in 
the set. This tag variable must be a component of the same record and 
pet precede the prtent Begin DST record in the DST. the Variant 

Beg 9 0s! recere also gives the bit size of the variant, if known at 
compile-time. 


The Variant Value DST record marks the yogrenen of a single record 
variant. It also specifies all tag variable values or value ranges 
that indicate the presence of this variant in a given record object. 
ALL record components (indicated by data DST records) after this Vari- 
ant Value DST record and before the next Variant Value or Variant Set 
End DST record are taken to be components in this variant. 


The Variant Set End DST regere marks the end of some set of variants 
wi seie 2 recere specification. It also terminates the last variant 
w n the set. 


A record type with variants is thus specified as follows. First a 
Record Begin DST record marks the beginning of the record specifica- 
tion. After that come data DST records that denote all fixed compo- 
nents of the recor Cypee: Then comes a Variant Set Begin DST record 
that marks the beginning of a set of variant definitions and identi- 
fies the tag variable (if any) for that variant set. Immediatel 
thereafter comes the first Variant Value DST record. It marks the 
start of the first variant and identifies the values or yelue ranges 
of the tag variable that correspond to this specific variant. 


After the first Variant Value DST record come the data DST records 
* for the record components in this particular variant. Next comes the 
Variant Value DST record for the next variant, along with its component 
DST records, and so on for each variant in the yer tant set. After the 
He | Component OST record for the last variant in the set comes a 
Variant Set End OST record. It is followed by the DST records for any 
additional record components, poss {bly including additional variant 
set definitions. Then comes the the Record End DST record. 


Vor tant. sets may be nested inside yer tant sets. Such nesting is _ indi- 
cated in the DST by the corresponding proper nesting of Variant Set 
tet End DST records. 


Begin and Variant 
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THE RECORD BEGIN DST RECORD 


The Record Pegin 05 a 3 qroenee marks the beginning of a record type 
definition T. It must rw followed by the DST records for 
the components of that record and by a match ng Record End DST record. 
the Record Begin DST record has essentially th ne same format as the ° 
peeneers Data DST record. but with two exeaee ons. df wees an extra 
Scee VFL ves the bit length of the at vale ype ane ond, the 
pee GS viele may have pe. special v give STSK. “VELAGS “hovat to 
indicate that this : gtr wz 3 ype definition, not also the defini- 
a normal Lyalue specification is used. a 


tion of : record obje 
record object is be m9 “See ared a 


ove os - record type. this 
case, a Trailing Value Specification sep be included at the wad of the 


FIELD OSTSRECBEG TRAILER FIELDS = 


41 
4 DSTSL_RECBEG_SIZE =C0,tL.] ! The bit size of data gbjects of this 
4 ; : record type (or f unknown) 


TES; 


1 P 

1 : 

i : 

1 Ps 

i Py 

1 ; 

! 3 

! ; 

! 3 

! 3 

! 3 

! : 

! 3 

! $ 

t8e DST tecore if necessary to describe the record's address. : 
108 ! The bit size of objects of this record type is also given in the DST ; 
0 ! record. This size should be included if the size is known at gonp tee ; 
bs } time. If it is not known at compile-time, it showla be specified as $ 
ret sero. : 
\} This is the format of the Record Begin DST record: : 
ig : 
14 ' dew erence ne eee ee ew ewww were wee menace eeseceeeeeeeeoeoceae wcmereesneczces + P+ 
1? byte : DSTSB_LENGTH H : 
Hi i byte | DSTSB_TYPE (*DSTSK_REGBEG) i ; 
i$ i byte } DSTSB_ VFLAGS ; : 
0 ! ¢eceeus eenrecenr ene eneeses wen esos ets ew eee esens weerereeee eee ecenmeeecon = + ; 

1 long ! DSTSL -VALUE ' : 
4 i byte | DSTSB_NAME ; 
4 ' ¢ ew wmevewrceeeewc= See sete oweowr macros seoee Deca m anwar nenwnraonoraeseae emo} P+ 

5 ! var H ' : 
$ } ' The Name of the Record or Record Type in ASCII ; 
8 (The name's Length is given by DSTSB_NAME) ' : 

i : 

1 ' torecece SKS KEN H RUN BTE NMED BE DEE moO Mae OR Bee sme Eerememnwn nme wrer ee ew es =-+ 3 

§ long H DSTSL _RECBEG_ SIZE ! : 
23s 
: : 

i Define the fields of the Record Begin DST record. Also declare the macro 3 

: that defines the trailer part of the DST record. : 

40 F ; 


46 MACRO 


byte 
byte 
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DSTSRECBEG_TRLR = BLOCKL,BYTE) FIELD(DSTSRECBEG. TRAILER.FIELDS) 4; 


THE RECORD END DST RECORD 


im Be pegore yt ore works Soe end of a record type snatch in 
" rminates the scope set u matc 
Roterd T beatae 5 DST record. This j , fo . - $ 


$s the record's format 
+e eeeeecee SPOT BeBe Swe Bee TD a eee ono men weno Boe ae wren n scene nen n awn s + 
H DSTSB_LENGTH (= 1) H 
om ae ee oe meee wewew ewww weeeeeews ecco woeeceocescecoeeccceccececcece=} 
' DSTSB_TYPE (= DSTSK -RECEND) H 
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THE VARIANT SET BEGIN DST RECORD 


The Variant + Begin DST reserve rz ph the beginning of the DST 
escrie Fron of a set of record vari ts. T record also 
Ries’ the ta ver able that diece Seated bety tween the variants 
a the variant se The tag ver ieeer is peqnesiie y @ point 
o the DST record for the tag variable. 

of a byte address relative to the start io the dst? 

ts of this variant +4 2 mean "9 the size of the largest variant 
n the set, is also included. this size is not known at compile- 
time, it should be set to zero. 


This is the format of the Variant Set Begin DST record: 


"se ner’ consists 


A OODNOUES WN" OODONOW 


pe ees 


Sessa wee meonneaa~ weoeeerowa + 


\ 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
: 
~psi88. NAME ' 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
F 


The Name of the Variant Set in ASCII 
(The name's Length is given by DSTSB_NAME) 
(This name is normally null) 


6 
ee ee 


i Long 
i Long DSTSL “VARBEG. TAG, PTR. 


tere wow e ee mee me ce rene a eS 


Define the fields of the Variant Set Begin DST record. Also define the 
declaration macro for the trailer part of the record. 


IELD DSTSVARBEG_ TRAILER _FIELOS ~ 
DSTS$L_VARBEG_SIZE =({0,tL. 1], Size to bi bits 8 of verient, pert 
DSTS$L_VARBEG_TAG_PTR =€4,_) Pointer to TAG field DST 
i 


record relative to the 
start of the DST 
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TES; 
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DSTSVARBEG_TRAILER = BLOCKC,BYTE) FIELD(DSTSVARBEG_TRAILER_FIELDS) 2%; 
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THE VARIANT VALUE DST RECORD 


The Variant Value DST record marks the beginning of a new record 
variant within a variant set. Is also marks the eng of the rey lous 
variant (if any). It is always ound between a Variant Set Begin 
and a Variant Set End DST record. Since the Variant Set Begin DST 
record has already spec fied the tag variable, the Variant Value 

DST record only specifies the tag value or va ues that gorresgond 

to the present variant. It also specifies the s ze in bits of this 
variant if known at congt ier me (otherwise zero is specified). The 
Variant Value DST corers s followed by the data DST records (includ- 
ing nested variants if appropriate) which constitute the components 
of this specific variant. 

A variant may have many tag values or tag value ranges. This DST 
record thus specifies a se of tag value ranges. The way these 
ranges are specified is described in detail on the following page. 


This is the format of the Variant Value DST record: 


' 

i 

i 

i 

i 

i 

i 

i 

i 

i 

i 

i 

i 

i 

i 

i 

i 

i 

i 

i 

i 

! feeenw en eoceeosaa= snes eeocaae Se aaron menrses ee etr esa eee oeace = sees sea ee + 
i byte } DSTSB_LENGTH 
' peeeece seo ne wo ececsane SSS SS Bae Too ee OEMS Bem aneas etree oa we Sew a oe ee 
' 
' 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
F 


byte i DSTSB_TYPE (= DSTSK_VARVAL) ' 


$¢ eee s mew ere e ee me momen aoe oe oe SE OR eR mam ae ewe omc memen ee + 


long } DST$L_VARVAL_SIZE 


be oem ee meee men eee ee me eee cee soe Seat ee reece nee erea eas Soc eer eoeoceoe + 


word ; DSTS$W_VARVAL_COUNT 


var 


Zero or More Tag Value Range Specifications 
(The number of Range Specs is given by DST$W_VARVAL_COUNT) 


} eceecceceseccs > oo 


Define the fields of the Variant Value DST record. 
IELD DSTSVARVAL_FIELDS = 
SET 


DST$L_VARVAL_SIZE = f 2. Le }: 
DST$W_VARVAL_COUNT =C6,W_ J, 
C8, AL] 


DSTSA_VARVAL_RNGSPEC = 
TES; 


Bit size of this variant part 
The number of tag value ranges 


which follow 
Location where the tag value 
range specs star 
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TAG VALUE RANGE SPECIFICATIONS 


Each Tag Value Range Spec! {ication in a Variant Value DST record 
consists of a byte specifying the kind of the range specificatio 
tol Loved by one or two value Spec ts scat ons. If one Value Spec 
fication is given, that he fag value=-the range consists 

if fications are given, they spe 
fy the lowest and highest values in the tag value range. The 
stra 


ves 


that one value. two Value Spe 


FUSVSV SVS 


as em 


ao 
oo 
SOQqooooooocoqooooocoooooooooooooooooooooooooOoOoOOO OOO OOOO OOOO 


Define the fields of the Tag Value Range Specification. 
IELD DSTSYARVAL, AG _FIELOS = 


DST$B_VARVAL_RNGKIND 
DST$A~VAL VAL RNGADDR 


TES; 


' 
i 
i 
' 
i 
: 
t 
i 
i 
' ; ons below show the two possible formats of Tag Value Range 
; } Specifications: 
i 
a 
5 1 byte | DSTS$B_VARVAL_RNGKIND (= DSTSK_VARVAL_SINGLE) 
$96 ivar 3 DSTSA_VARVAL_RNGADDR 
236 | A DST Value Specification Giving a Variant Tag Value 
594 i 
a2 treme nn wenn nnn enn nner wenn wn ee nw ne ewww ences ences eeseceesecene= 
399 i 
598 ' 
599 i teeenennn ene e222 2-22-2222 3-2-2 3-22-23 -- = +--+ == + 
ret byte H DSTSB_VARVAL_RNGKIND (= DSTSK_VARVAL_RANGE) 
ivar | DSTSA_VARVAL_RNGADDR 
rer) A DST Value Specification Giving the Lower Bound 
606 ; for a Range of Variant Tag Values 
08 i 
609 ‘ tome mew ewww nese e sees enone eee ese enenecereosooecesececcoee= 
6 ‘var } 
' A DST Value Specification Giving the Upper Bound 
for a Range of Variant Tag Values 
Iiccewinee-libervasspeidcivennstisesiicienibaliaielsbuaursicusdinnapsdudenpannsintaioen 
! 
1 
i 
' 
i 
F 


! Tag Value Range Spec k 
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! Define the possible values of the DSTSB_VARVAL_RNGKIND field. 


VAX 
82 


n 


ie- 


of 
ci- 


tlu-" 


} coceswcccen } ow } 


ed ee Cee o 


ind 


Location of first Value 
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' 
LITERAL 


DS 
DST 


TSK 


$k 


K_VARVAi. .sINGLE 
K-VARVA! ~RANGE 


13-50 


The range 
The range 
uppe 
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geneists 6 of a single value 
s given by a lower and an 
r bound (two value specs). 
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THE VARIANT SET END DST RECORD 


The Variant Set End DST re ore marks the end of record variant set; 
it terminates a set of var aor s which have the same tag variable. 
This is the format of the Variant Set End DST record: 


eemmweeeweeeoeeeeeeeeececoeeecesseccesececeoeceececoceccecocees + 
byte |i DST$B_LENGTH (= 1) ! 
byte ‘ DSTSB_TYPE (= DSTSK_VAREND) H 
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BLISS DATA DST RECORDS 


BLISS data objects are represented by poverat ¢/ ortre rent kinds of DST 
records. Or dinary scalar objects, _ as simp Integers, are repre- 
sented by t he Standard Data DST record or its a on s. However, the 
more specialized BLISS data types such as Vectors Bitvectors Blocks, 
and pLockvec tors. are poperecsees pate a special D Sf record called 
BLISS Special Cases DST record. Po nters to such objects {e.9. hee 
VECTOR) are also represented by this DST record. In additi “BLISS 
Yield names are represented by their own kind of DST re phd "the LISS 
Fie eld DST record. Both of these record kinds are described in this 
section. 


The BLISS Special Cases DST record and the BLISS Field DST record are 
supported for BLISS only. They should not be generated by compilers 
for any other Language. 


DVS 


—OVDONOULSWN—O” 


WBodepct9ee 25:08:08 Vays] Bt fese2 v4 


P 
BKDST.REQ;1 age <8 


& 


THE BLISS SPECIAL CASES DST RECORD 


3 7 ! 
i 366 i 
os. : 
3 ! The BLISS Special Cases DST record is used to d i 
of gare ¢ abjects whose data types are specific to fhe GLTSs" Language’ fois } 
ore My . ncludes such objects as BLISS Vectors, Bitvectors, Blocks, and — ; 
of? mare eaewere ong Peroter s to these objects (REF VECTOR, REF BLOCK, 
; is | ~ > obne ea Ieee record should not be generated for any language ; 
: 367 i This DST records consists of four : 
parts: The DST h : 
BRE | tle tathe’age BEL ceecaceedeate Guar reste (tate : 
ret e. Higids et be em tye et of the eS ids in peTsaci ver PreLos. 
HD Betlelte te tRRTL eich clebecotte nates se sy ict aoc ties. ; 
3 ret + variable-length part depends oe value of BLISV “BLI eppers 
eae 8 which indicates which type of symbol is being defined. Ys : 
; ty, 8 This is thus the format of the BLISS Special Cases DST record: : 
; 3688 0 i 
3 689 0  darhethaheheherhaheteeataraheetataateteebebaehatatababelabatatatetateatatatateetenatate eoeceeon- + 
re 8 ; byte H So ae Ae a a Nad DSTSB_ LENGTH H 
3 ieee ~ _____DSTSB_TYPE SME a. H 
cs ee One eee eaee oe, oS OO MR RMR Gn ome get an ee H 
Be BES SN DST$B_BLI_LNG 3 
3 Bo Cs seen Hania. H 
BBB Bis Ret cece DSTSB_BLILVFLAGS i 
: 3700 0 | byte 1BLI_AEF Post Unused--Must Be Zero i DSTSV_BLI_STRUC.! } 
4 3 var ; DSTSA_BLI_SYM_ ATTR IPSEC RRC sag ' 
ie Variable-Length Portion of DST Record : 
: 706 i 
; 70 : tHeowoemne ween eweseneeeesesncesesesescocoscecoecoroccccoccsese H 
re long i eae | eI SE | DSTSL_ BLI_VALUE H 
: 210 fete fs rae DSTSBBLILNAME : : 
i $i 10. 8S Bay et es Oren eT Ge ae H 
; 213 The BLISS Symbol Name in ASCII 
ay } ' (The name's length is given by DST$B_BLI1_NAME) : 
: a9 i 
: ie i s ininlenieiihetticar nnriesemsinasioeuanieiuniiienneneneicenmenenssenit ' 
3 Ay, long i ee PRP DSTSL_BLI_SIZE H : 
: i ee se RRO EE eR ER RINE RINE BT RE ih ’ 
: 7 ‘ 
: 37 4 i ; 


So Dt be tb be ie i Se Sn Se | 


“ re ae 


AA 
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The yar iable-Length portion 3°! sh : DST record can have severai forms 
as discussed above. One BPE bil ty is that it is absent altogether. 
This occurs if the DST$V_BLI *STRUC + ield contains DSTSK_BLI_NOSTRUC. 


However, if DSTSV_BLI_STRUC has the value DSTSK_BLI_VEC, the variable- 
Length portion of the DST record has the following format 


4 P $e eeeeoccoere eeecee Seeeeeeeaoeaeaeon wer wrerewrnocererreceer wee een = Coa aeemaeacece $+ 
! Long t DSTSL ~8L1 VEC. UNITS y 
i byte { DST$V_BLI_VEC -S1GN_ EXT ! DST$V -BLI_VEC UNIT SIZE 4 


If DST$V_BLI_STRUC has the value DSTSK_BLI_BITVEC, the variable-length 
portion of the DST record has the following format: 


i long } DSTSL “BLI _BITVEC SIZE 


If DST$SV_BLI_STRUC has the value. DST$K_BLI_BLOCK, the variable-length 


! teecnen= wenn enn nnn nee e ene e sc ceccesece= woe rere w en eesecee= 4 
i tong DSTSL -BL1 BLOCK UNITS i 
i byte i Unused i DSTSV_ BLI_BLOCK_UNIT_SIZE | 


De Se Se Se Fe Se Se Se Ge Se Se Se Ge Ge FH Te Ge Ge Be Se Se Se Be Ge Ge Se FH Se Ge Ge FH SH Se Os Se Se Be Se Ss Oe HSH Se Os Oe Oe Oe Oe OH He Oe OH Os oe Oe ee 


PVPS ES = ne = 
DOONAUE WN 0 ODO UENO ODNOUE WW OOOO 


NNN NNN NNSA SSS 
MEW 
SOoqoooooocoocoooooooocooooooooooooCooCooOCOOOOOOO OOOO OOOO OOOOOOoOOo 


Oo 


If DST$V_BLI or has the value DSTSK_BLI_BLKVEC, the variable-length 


portion of the D 


! temenmnn nen eenenennee=- a eh a teeta + 
i tong } DST$L_BLI_BLKVEC_BLOCKS : 
i Long i DSTSL ~BLI_BLKVEC_UNITS : 
i byte i DST$B_BLI “BLKVEC UNIT “SIZE : 


1 
! 
' 
! 
! 
! 
' 
! 
1 
' 
! 
! 
! 
! 
! 
! 
' 
1 
1 
1 
' 
i 
! 
i 
1 
' 
* portion Of the DST record has the following format: 
' 
i] 
' 
' 
' 
1 
i] 
1 
! 
1 
! 
1 
' 
1 
' 
! 
i 
1 
1 
' 
1 
' 
i 
i 
i 


ST record has the following format: 


Define the fields in the header portion of the BLISS Special Cases DST 


Record. 
FIELD DSTSBLI_FIELDS = 
SET 
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attribute segment 
this DST record 


15-5 Sep-1 9: VAX=-11 BLi 
13-8b-19Re S3:S0:s6 — “Sdsb$ouas 
DST$B_BLI_LNG . =(€2, 6.1], ! Length in bytes of the set of 
i fields between this one 
and Teall FIELDS 
i between 3 a 
DSTSA_BLI_TRLR1 =(€3,A_], i The f res frailer. 1 7 this 
location + 3tNG 
DST$B_BL1_FORMAL =(€3, 6.1], i Flag set if Chis’ ; yabste . 
i routine forma pereneter 
DST$B_BLI_VFLAGS = f 4, BL : i Value access Intermatic on 
DST$B_BLI-SYM_TYPE etd &. de i The type 0 of the BLISS symbol 
i e described bY the fol- 
; low ng sub-f gs: 
DST$V _BLI_STRUC = { 5. V_.(0,3) J], ! The structure of this symbol 
nused ~ = 2° V.(3,4) J, ! This field Must Be Zero 
bstsy _BLI_REF - « V(7,1) ! ' Fla set f this 1s a id 
REF, 0 = no REF) 
DSTSA_BLI_SYM_ATTR =(€6, A, ] Address of variable Len eh 
i 


TES; 


These are the possible values of the DSTS$B_BLI_STRUC field. 
LITERAL 


DSTSK_BLI_NOSTRUC = 0, ' Not a BLISS structure 
DSTSK_BLI_VEC = 1, ' BLISS Vector 
DSTSK_BLI_BITVEC s ¢ ' BLISS Bitvector 
DSTSK_BLI_BLOCK = 3, ' BLISS Block 
DSTSK_BLI_BLKVEC = 4; ! BLISS Blockvector 
' Define the fields in the variable-length part o e BLISS Segc tat Cases 
! DST record when the value of the BLISV_BL +S FRuC ned is DSTSK_BLI_VEC. 
This field describes a BLISS Vector. 
FIELD osTseu! -VEC_FIELDS = 
SE Tsi _BLI_VEC_UNITS 't G& 4. fe Number oft, Stenents allocated 
e vector 
DST$SV_BLI_VEC_UNIT_SIZE = (C 10, v_(0,4) ae ! ‘st er tes egy unit 
° +h = 


ond ® ¥ ‘ tlongvord 
DST$V_BLI_VEC_SIGN_EXT = (C 10, V_(4, 0} ! Sign. hae on 

1 = sign aunt on 
0 = no sign extension 


TES; 
Define the fields in the variable-length Buf stro tt SS Special Cases 
DST record when the value of the BLI$ Fae nes s DS i" BLI_BITVEC. 
This field describes a BLISS sectors 


' 
i 
i 
i 
FIELD DSTSBLI_BITVEC FIELDS = 

Pe iSt OL! BITVEC SIZE = (€ 6, L_ ] ! The number of bits in the bitvector 
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' Define the fields in the vas "epee eos art of the BLISS Special Cases 
i DST record when the value oft i30'B hie STRUC { ghee i; D Sk BLI_BLOCK. 
These fields describe a BLISS ‘at A.’ 4 np Seca 


FIELD OST S9LI BLOCK FIELDS = 


DSTSL_BLI_BLOCK_UNITS =(€6,tL. 1, ! The nyaber of units allocated 
: in the block 


DSTSV_BLI_BLOCK_UNIT_SIZE = C 10, v_(0, 4) ] ! The unit size of the 
lock: 1 = byte, 2 = 


word, and 4 = Longword 
TES; 


! Define the fields in the yo te ay: th Bue STR 
! DST record when the value of t Fave 
' These fields describe a BLISS y A 
FIELD DSTSBLI_BLKVEC_FIELDS = 
DSTSL_BLI_BLKVEC_BLOCKS = (CC 6, L. J, ! The number of blocks in the 
-blockvector 


' 
a 

DSTSL_BLI_BLKVEC_UNITS = f 10, L 1.1 ihe number of units per block 
' 


BLISS Seec tat Cases 
is DSTS$ 


eld s K_BLI_BLKVEC. 


DST$B_BLI-BLKVEC_UNIT_SIZE = he block unit size: 1 = byte, 
Tes: = word, 4: longvord 


! Define the fields in the first trailer portion of the BLISS Special Cases 
DST record. Also define the declaration macro. 


F1eLD DSTSBLI_TRAIL1_FIELDS = 


DSTSL_BLI_VALUE = C 0, L_ J, Value longword, interpreted 


acco ah a A ggatents of 


' 

i 

i OST$B_B 
DST$B_BLI_NAME =([ 4, B_ J, i Count byte of thee syabol name 

i Count ed ASCII strin 
DSTSA_BLI_TRLR2 = C 5, A_ J] i The second trailer stores at this 
res ; location + DST$B_BLI_NAME 


MACRO 
DSTSBLI_TRAILER1 = BLOCKC, BYTE) FIELD(DSTSBLI_TRAIL1_FIELDS) 2%; 


! Define the fields in the second trailer portion of the BLISS Special Cases 
DST record. Also define the declaration macro. 
FIELD OSTSaLt. TRAIL2_FIELDS = 


pars. BLILSIZE =C€ 0, tL. ) ! Size of the Bliss data item in bytes 
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3532 8 MACRO 
96 DSTSBLI_TRAILER2 = BLOCKC,BYTE] FIELD(DSTSBLI_TRAIL2_FIELDS) %; 
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Dwr 


THE BLISS FIELD DST RECORD 


The BLISS Field DST record describes a BLISS field name. BLISS field 
names are declared in FIELD declarations in Of8s, Each BLISS field 
name is bound to an n=tuple of numbers. Usually the n-tuple is a four- 
tuple and the numbers represent a byte or yenpuere offset, fhe bit 

set within that byte or rongword. the bit length of the field being 
escribed, and a sign-extension flag. DEBUG suppers references fo 
such fields in BLISS Blocks and Blockvectors. However, a BLISS field 
can be any n-tuple. If n is not 4, the field name can only be used in 
EXAMINE commands, but not in Block or Blockvector references. 


The BLISS Field DST record should not be generated for any language 
other than BLISS. This is the format of the record: 


poem na meena s eseecee Seen eee een ar wre ewe ro mome cee eee eee een eee mere m ewe + 


| 

i 

! 

i 

i 

1 

i 

{ 

i 

i 

1 

i 

i 

' 

i 

t 

| byte. DST$B_LENGTH ! 
byte } DST$B_TYPE (= DSTSK_BLIFLD) : 
! byte | DST$B_BLIFLD_UNUSED 7 
; Long : DST$L_BLIFLD_COMPS : 
| byte | DST$B_BLIFLD_NAME i 
i var H H 
; The Name of the BLISS Field in ASCII 
(The name's Length is given by DSTSB_BLIFLD_NAME) 
Roc , | 
i $eeeesecoeeooeccee= wecccoeceesceee errr e rece meee eee eeeeceee= + 
' var H ' 
A Vector of Longwords Containing the Integer 
i Values of the Components of the BLISS Field Definition | 
(The number of values is given by DSTSB_BLIFLD_COMPS) 
ae | 
i jueeNanneneRENEnedETTeNdTeinmneneineeEENiON eee | 
C 

i 

! 

Define the fields of the BLISS Field DST record. 

f 


IELD DSTSALIFLD_FIELDS = 
DST$B_BLIFLD_UNUSED = — & * 
DSTS$L_BLIFLD- COMPS 2 ; oe 
DST$B-BLIFLD-NAME = 8 


TES; 


Unused--Must Be Zero 

The. number of components 

The count byte of the field 
name Counted ASCII string 
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LABEL DST RECORDS 


Labels are foprecqates by two different DST records. A label, in the 
sense used here, ymbol bound to an instruct on oterer. Labels 
ge not include heutine.” lexical block, and prtcy point symbols, apwever's 
A label can be rearesentes by either a Label DST record or a Label-or- 
Literal DST record. The Label=or-titeral DST record is intended only 


WR —"OODONOULEW 


S32F 
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for language MACRO, it appears. (The Diptery rh nite ip grarem 
e uage uld use 


of this record is sesteet however.) ALL ot 
the Label DST record for labels. 


THE LABEL DST RECORD 


The Label DST record specifies the name and address of a label in the 
the current module. A label in this sense is always bound to an in- 
struction address, not a data address. This is the DST record normally 
used for labels in high-level languages. The DstSt. VALUE field of this 


record contains the code address to which the Label is bound. 
This is the format of the Label DST record: 


byte ' DSTSB LENGTH H 
byte H DST$B_TYPE (= DSTSK_LABEL) H 
byte i Unused--Must Be Zero H 
long ‘ DSTSL_VALUE ' 
byte : DSTSB_NAME H 
Powe emer ener eee were rr eet ew o emer noeme a a em ee eee ee eee eS tb 
var ' ' 
' The Label Name in ASCII 
(The name's length is given by DST$B_NAME) 
’ eeeeeooeeos SS 22S SSS SSS SSS SSS SSS SSSSSSSSSSEeS Se ee eee eee eee eeeeee ian 
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THE LABEL-OR-LITERAL DST RECORD 

The popet worst tteret DST roqere specifies the name and gcérese of a 


rye a: a code locat r the none and value of an integer 
Literal eres constant). It is not ert r 
n 


; ! P 
; : 3 
> ' Py 
3 ; F 
° 1 Ps 
Ps i record at. since labels can be described by Label DST records and 3 
; 4005 ' integer literals can be coger ieee ¥ with Standard Data DST records. ; 
; rt : Most sjeety ct this record was intended for henguage MACRO where ; 
: 400 ' there is Little sf stin tion eepusen labels and Literals; one is relo- 3 
: 4008 i catable and the other is not hat is about all. if DSTS$V_VALKIND ; 
: 1008 : has the velue Ost K_VALKIND Ano, iy symbol is a label and if it has F 
: 4010 ! the value DSTSK VALRIND. LITERA he symbol is a literal. The address 3 
; ©4011 ! of the label or the ava fh of che titerst is found in the eit VALUE F 
3 tog : t elds It is recommended that high-level Languages avoid this” 3 
; 401 ! record and use the Label DST record or the Standard Data DST record : 
: tole instead. : 
; $38 ; This is the format of the Label-or-Literal DST record ; 
: 4018 i 
: ©6401 ! sashes hhesheeaterheerierha teria hehehehehe eheheelebeetebebebatabebatetatatatatabatataeaatenatataaaetaneaten + ; 
; rt byte Hl DSTSB_LENGTH H : 
: 40 ; byte | DSTSB_TYPE (= DSTSK_LBLORLIT) i ; 
i 4084 i byte { Unused=-Must Be Zero 1 _DSTSV_VALKIND { : 
: 4086 9 = Long DSTSL_VALUE So a ; 
; 408 ' byte i DSTSB_NAME : ; 
; 4030 ivar | : 
3 $03) 0 } " ' The Label or Literal Name in ASCII : 
: 4038 0 (The name's Length is given by DST$B_NAME) : 
: 4035 0 i F 
; 4036 ; toemewewwnnennnennnneewennesewcewennecneeeeeecncoeeccooccoccccce + : 


oS 
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THE ENTRY POINT DST RECORD 


The Entry Petes +H record se itegese an ENTRY name in the FORTRAN so 

PL/I sense. a gee er wores t descr 

the routine within which t 

never be ntfs alrea for A, { ain "byt poi ie @ a routine since that 
he Rout ne Begin. DST record, An 

Point DST recor 
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Pt wt ot ot a a 
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3 
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beret _VALUE field gh the ¢ the address of the entry point. 

This is the format of the Entry Point DST record: 

pone ane cS Se we ge ee om ep ee eo me me ee mem me ee we ee me oe ee mee Dm ee ee ee + 
byte H DSTSB_LENGTH H 
byte H DSTSB_TYPE (= DSTSK_ENTRY) H 
byte ! Unused--Must Be Zero : 
long : DSTSL_VALUE : 
byte } DSTSB_ NAME H 

tec m ewe ewe em cme een nme remem emo em moe seme em mew ee mee meee me em emowmeecone + 
var H ' 

' The Entry Point Name in ASCII ' 

(The name's Length is given by DSTSB_NAME) 

nj enin-seetesiinsessedaerinstanasaseiatetehnseeaneninennenniaemeenremnenomenienendennatinniinarnent + 
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FIELD esrorsect FIELDS = 


DSTSB_PSECT_UNUSED = + O. ae ! Unused=--Must Be Zero 
DSTSL_PSECT- VALUE = » tee ae ! Start address of the PSECT 
DST$B_PSECT_NAME = o GO Je ! The soute byte in the PSECT 

} e C end ASCII string 
DSTSB_PSECT_TRLR_OFFS =( 7, 8B. J, ' Byte offset to the PSECT DST 

: record trailer fields 
DSTSA_PSECT_TRLR_BASE =( 8, A_ ] ! Base address for offset to 
res : DST record trailer fields 


: Define the PSECT DST record trailer fields. Also define the declaration 
! macro. 
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THE PSECT DST RECORD : 
=e PSECT DST record g prec "ties the name, address ng Length of ; 
PSECT, where a P S$ a Program Section in the. l ff genes. 3 
PSECT d§T records os only used for Language goetes “ere {§ is 3 
pessteta to generate code or data at the beginn niet ECT 3 
without having ~ other Label on that code ro A ignores “PsecT H 
CST records for all other -pnguages since Right evel eke : 
have other code and data labels that are more appropriate. : 
This is the format of the PSECT DST record: 3 
seein enighiinenqeninaphimesiap-ctnnlaniliunenteetesnanineniancry 
byte HN DST$B LENGTH H ; 
byte. { DSTSB_TYPE (= DSTSK_PSECT) i 3 
byte } DSTSK_PSECT_UNUSED i 
long | DSTSL_PSECT_VALUE ! ; 
! byte ' DSTS$B_PSECT_NAME (also DSKSB_ PSECT _TRLR OFFS) ! F 
var} DSTSA_PSECT_TRLR_BASE ; 
The Name of the PSECT in ASCII ; 
(The name's Length is given by DSTSB_PSECT_NAME) 
a eonnno=-------—- eonnnennnnnenn-nnncnnn a ‘ 
long H ; DSTSL -PSECT SIZE H : 
Define the fields of the PSECT DST record. . : 
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FIELD DSTSPSECT_TRAILER_FIELDS = 


SL_PSECT_SIZE = ( 0, L_ J ! Number of bytes in the PSECT 


MACRO 
DSTSPSECT_TRAILER = BLOCKC,BYTE) FIELD(DSTSPSECT_TRAILER_FIELDS) %; 


: Note that the address of the PSECT DST record tailer is conguted as follows: 
i DST_RECORDCDSTSA_PSECT_TRLR_BASE] + -DST_RECORDCOSTSB_ASECT_TRLR_OFFSI 
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LINE NUMBER PC=CORRELATION 
DST RECORDS 


The Line Number PC-Correlation DST record specifies the correlation 

between Listing Line numbers, as assigned by the compiler, and PC 

addresses. It thus the means whereby the rynetter tells BEBUG where 

the generated object tego for each source line starts and how lon 

aiy's in artes. This is the format of the Line Number PC-Correlation 
record: 


0 eee nan eno - eee sean eae aa conn ae aeneoee woaa 


t DSTSB_LENGTH 


ween ene meno ammo meee cee near ems Serre wee mes em ese see eer eee ee mown ece } 


DSTSB_TYPE (= DSTSK_LINE_NUM) 


H 
One or More Line Number PC-Correlation Commands 


} cowewcce > on 


After the two-byte header, each Line Number PC-Correlation DST record 
contains a sequence of Line Number PC-Correlation commands. Each such 
command sets or manipulates one or more state variables used by DEBUG 
in the interpretation of these commands. The main state variables are 
the current Line number and the current PC address, but there are seve- 
ral others as well. The exact semantics of the various commands are 
described in the sections that follow. 


Line Number PC-Correlation DST records are associated with the module 
within which they appear. The must thus speeer between the Module 
Begin and the Module End DST records for the current module. There are 
no further restrictions on where “| may a gear. however. In particu- 
lar, they need not be nested within the routines or lexical blocks that 
Frey describe. It is thus legal to generate all Line Number PC-Corre- 
Lation DST records for a module after the Last Routine End DST record, 
for instance. These records can also be interspersed between Routine 
and Block Begin and End records in any way convenient for the compiler 
implementer. However it is done, DEBUG treats them as belonging to the 
module as a whole. 


The Line Number PC-Correlation information may be spread over as many 

DST records as necessary. No Line Number = orrelation command may be 
broken across record pounder es, but otherwise the Line Number PC-Corre- 
lation DST records within a module are considered to constitute a single 
command stream. The Continuation DST record may not be used to continue 
Line Number PC-Correlation DST records. 


i Define the fields of the Line Number PC-Correlation DST record. 


Pa 
BKDST.REQ;1 


12 
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4197 ' 
7135 FIELD OST) INE WUA_FIELDS = 
5 9 Pa tSA_LINE WUR_DATA = (2, A. 1]! Start address of PC-correlation data 
4308 ‘ ; 
420 
4204 
4205 LINE NUMBER PC-CORRELATION COMMANDS 
}: $388 
4 Ag Each PC-Correlation command consists of a command byte possibly fol- 
4 lowed by = parameter byte, word, or longword. The presence, size, and 
4 meaning of the parameter field {s determined by the command byte. This 
: illustration summarizes the structure of one command: 
{ee meee wee wee ee eres Sew Oe moe ee iin aie et + 
byte COMMAND _BYTE 
var 


Zero or One Parameter Field 
(Byte, Word, or Longword) 


The command byte contains a command code. If this command code is 
negative, this is a Delta-PC command. A Delta-PC command specifies 
by how 1p | bytes to increment the PC to get to the start of the 

next Line (see detailed description below). This byte count is en- 
coded Siroctty in the command ytes If the command code is negative, 
its negative is the PC increment. The Delta-PC command has no param- 
eter field. If the command code is positive, it specifies some other 
command as described below. In this case, there may be a parameter 
field, depending on the command code. 
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3 
39 Define the command codes alowed in Line Number PC-Correlation commands. 
40 If the command code is zero or negative, the command is a one-byte Delta-PC 
a command. Here we define the command-code range for the Delta-PC command. 
rk ITERAL 
44 DSTSK_LELTA_PC_LOW = -128, ! The lower bound on Detta-PC commands 
4g DSTSK_D&LTA_PC_HIGH = 0; ! The upper bound on Delta-PC commands 
4 
48 ! Define the PC-correlation command codes other than the Delta-PC command. 
56 These command codes are always positive. 
LITERAL 
6 DSTSK_DELTA_PC_wW = 1 ! Delta-PC Word command 
5 DSTSK_DELTA_PC_L = 17, | Delta-PC Longword command 
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>; 4254 DSTSK_INCR_LINUM 5 ¢: ! Increment Line Number Byte command : 
> 4255 DSTSK_INCR_LINUM_W = ! Increment Line Number Word command : 
; § § DSTSK_INCR how L = 16, ! Increment Line Number Longword command . 
—)s DSTSK_SET_CINUM_INCR = 4, ' Set Line Number Increment Byte command ; 
3; § 28 DSTSK_SET LINUM_INCR_W = 5, ! Set Line Number Increment Word command : 
: «425 DSTSK_RESET_LINOM_INTR = g. ! Reset Line Number Increment command ; 
; 4260 DSTS$K_BEG_STMT_MODE = 7, ! Begin Statement Mode comman 5 
; 4261 DSTSK_END_STMT MODE = 8 ! End Statement Mode command ; 
ae 6¢ DSTS$K-SET-STMTRUM = 1$, | Set Statement Number Byte command ; 
3; $26 DSTSK_SET_LINUM_B = 19, ! Set Line Number Byte command § 
; 4264 DSTSK_SET_LINUM = 9 ' Set Line Number Word command : 
; $265 DSTSK_SET_LINUM_L = #6. ! Set Line Number Longword command : 
:; 426 DSTSK_SET_PC = 10, ' Set Relative PC Byte command $ 
> 426 DSTSK_SET_PC_W = 11, ! Set Relative PC Word command : 
; 4268 0 DSTSK_SET_PC_L = 12, ! Set Relative PC Longword command ; 
; 6269 DST$K_SET-ABS_PC = 16, ' Set Absolute PC Longword command 3 
; 4270 DSTSK_TERA = 14, ! Terminate Line Byte command ; 
3; seri DSTSK_TERM_W = 15, ! Terminate Line Word command : 
3 : f 9 DSTSK_TERM_L = 21, Terminate Line Longword command : 
> 4274 DST$K_PCCOR_LOW = -128, | Smallest value allowed in the first ; 
; 4275 ! arse of a PC-correlation command 3 
5 627 DST$K_PCCOR_HIGH = 21; ! Largest value allowed in the first : 
; ? a . ! byte of a PC-correlation command : 
; 4379 0 ; 
; 4280 0 ' The parameter field, if present, contains an une igned byte, unsigned : 
:; 4281 0 ; word, or longword value. The possible PC-Correlation command formats : 
: 2 HG S thus look as follows: : 
: 4284 0 i ; 
3 4285 0 ' pemweeoeeoeewee oes wee eeeweeseeeeseeeeceeoeeeeceecoececceccccoes= + 5 
; 4 86 9 j byte { COMMAND _BYTE i ; 
; 4288 : i 3 
; $582 : 3 
3 4290 ' Pee wwoeeoweeeoe oe eee eeeeeeeeoeseceseseceeeseoeoeseeeccecoeeces= + : 
: ? 4 0 byte ‘ COMMAND _BYTE ! : 
; ‘ $8 9 i byte { NEXT_UNS_BYTE (Unsigned Byte Value) i ; 
i 4295 Ot ; 
: 4 38 i tere ree ee ee ee ee me ee eer ee wm come o ee we wert emer ese ee eee ee eee eee ee ee eo e= + : 
5 4298 ! byte } COMMAND _BYTE H 

3 4 99 ' pews ner oce ne mer emer eee mee ence ese eee eee meee oS ee Se Oe Oe ee ee + 

3 2 : ; word H NEXT_UNS_WORD (Unsigned Word Value) : 

Gk i 

3 i : 

| 4 ' fewer como mrerse woes ee wwe Bea mow msn weer e sce rm e ce w nem nem nwmowa= + 

3 $382 byte ! COMMAND _BYTE H 

; ‘ oF long } NEXT_UNS_LONG (Longword Value) : 

: 4309 i 

; 4310 : 
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PC=CORRELATION COMMAND SEMANTICS 


The individual commands are described teperately below. To clarify what 
these gonnengs “al t8s-t do, each is fol Loved by a formal semantic de- 

per ves . using BLISS-Like Mart eee p s description show what the 

command does to a number of state variables used by EBUG when inter- 

preting these commands. The state variables are the following: 


CURRENT_LINE == The current Line number. 

CURRENT. STMT == The current Fyasonens number. 

CURRENT_INCR == The current Line number increment. 

CURRENT_STMT_MODE == The statement mode eat | set to TRUE when 

statement mode is set, set to FALSE otherwise; 

START_PC -- the start address ‘le the lowest-address routine 
in the current modul 

CURRENT_PC <== The eres PC yatue "leote address). 

CURRENT_MARK == The | rqenepen | ne-closed flag; set to LINE_OPEN 
when Line numbers are being defined and set to 
LINE CLOSED when a routine has been terminated 
and few Lines are not being defined. 


The initial values of these state variables when the PC-Correlation 
commands for a given module are interpreted are as follows: 


CURRENT_LINE = 0; 

CURRENT. STMT = i; 

CURRENT “INCR 

CURRENT » STMT movi = FALSE; 

START_PC = S€art address of the lowest-address 
reve ne in the current module; 

CURRENT_PC = STA 


CURRENT_MARK = INES CLoseo; 


The sections below describe the format and semantics of each of the 
individual PC-Correlation commands. 


THE DELTA=PC COMMAND 


This command Get taee 3 sorretotion betupen » Line munber and a PC value. 
The current Line number ncremented by the current increment value 
(normally 1) and the current PC value is incronentee Y — negatives of 
the command byte. The resulting Line number then has ¢ resu ng Pe 

value. In other words, both the Line number and the Pg g Be are incre- 

mented before the correlation is establ shed, The PC increment value 

(the negative of a 4 command Ate thus spec cifies how man bytes to go 
forward to get to the start o ene Line bein 


g defined. These are the 
formal semantics of the command 


IF CURRENT. STHT_MODE 
CURRENT_STMT = CURRENT_STMT + 1 
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4 ; LSE : 
4 3 CURRENT_LINE = CURRENT LINE + CURRENT_INCR; ; 
437 i CURRENT_PC = CURRENT_PC = PC_COMMANDCCOMMAND_BYTEJ; 
‘ ue CURRENT_MARK = LINE_OPEN; ~~ 2 : 
4374 i : 
4375 ' The value of CURRENT_PC now contains the start address of the listing : 
4 6 : Line specified by the values of CURRENT_LINE and CURRENT_STMT. Note ; 
? f that Line-open mode is now set. ; 
1379 i ; 
4380 : ; 
4 81 THE DST$K_DELTA_PC_W COMMAND : 
rat i ; 
4384 : This command is Like the normal Delta-PC command except that the PC : 
4385 ' increment value is given in an unsigned word following the command : 
? a6 code. These are the semantics: ; 
4388 i ; 
£390 IF CURRENT_STMT_MODE : 
4391 CURRENT_STMT = CURRENT_STMT + 1 ; 
i CURRENT_LINE = CURRENT_LINE + CURRENT_INCR; 3 
4395 i CURRENT_MARK = LINE_OPEN; ; 
o3s CURRENT_PC = CURRENT_PC + PC_COMMANDCNEXT_UNS_WORD]; : 
4398 3 
43 ; The value of CURRENT_PC now contains the start address of the Listing : 
44 : Line specified by the values of CURRENT_LINE and CURRENT_STMT. Note » 
rr? that Line-open mode is now set. : 
440 i ; 
rts: : : 
46 5 THE DSTSK_DELTA_PC_L COMMAND : 
2209 i A 

4h ; This command is Like the normal Delta-PC command except that the PC 

4409 } increment value is given in an unsigned longword following the command 

re} code. These are the semantics: 

441 i 

rh! : IF CURRENT_STMT_MODE 

4415 CURRENT_STMT = CURRENT_STMT + 1 

461? CURRENT_LINE = CURRENT_LINE + CURRENT_INCR; 

$019 i CURRENT_MARK = LINE_OPEN; 

72 CURRENT_PC = CURRENT_PC + PC_COMMANDCNEXT_UNS_LONG]; 

44 i 

4h 4 ; The value of CURRENT_PC now contains the start address of the Listing 

4424 ; Line specified by the values of CURRENT_LINE and CURRENT_STMT. Note 
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that Line-open mode is now set. 


THE DSTSK_INCR_LINUM COMMAND 


This command increments the current Line number by the value given in 

the unsigned byte following the command code. If statement mode is set, . 
the current statement is reset to 1 as well. These are the formal 
semantics of the command: 


a) at te tt 


aon 
PRP R PREP PEPEE 


CURRENT LINE = CURRENT LI 
IF CURRENT_STMT_MODE TREN 


DWONAULSWN"OOONOW 


NE + PC_COMMANDCNEXT_UNS_BYTE; 
CURRENT STMT = 1; 


THE DSTSK_INCR_LINUM_W COMMAND 


This command increments ~ current Line number by the value given in 
the unsigned word following the command code. If statement mode is set, 
the current statement is reset to 1 as well. These are the formal. 
semantics of the command: 


CURRENT LINE = CURRENT_LINE + PC_COMMANDLNEXT_UNS_WORDJ; 
IF CURRENT_STMT_MODE TREN CURRENT STMT = 1; 


THE DSTSK_INCR_LINUM_L COMMAND 


This command increments the current Line number by the value given in 

the unsigned longword following the command code. If statement mode is set, 
the current statement is reset to 1 as well. These are the formal 

semantics of the command: 


CURRENT _LINE = CURRENT _LINE + PC_COMMANDCNEXT_UNS_LONG); 
IF CURRENT_STMT_MODE TREN CURRENT STMT = 1; 


THE DSTSK_SET_LINUM_INCR COMMAND 


This command set the current Line number increment value to the value 
specified in the unsigned byte following the command code, If state- 
ment mode is set, the current statement number is set to i. These are 
the formal semantics of the command: 


CURRENT _INCR = PC_COMMANDCNEXT UNS BYTE]; 
IF CURRENT_STMT_MODE THEN CURRENT_STMT = 1; 
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THE DSTSK_SET_LINUM_INCR_W COMMAND 


This command set the current Line number increment value to the value 

specified in the unsigned word following the command code. If state- 

ment mode is set, the current statement number is set to i. These are 
the formal semantics of the command: 


CURRENT _INCR = PC_COMMANDCNEXT UNS WORD]; * 
IF CURRENT_STMT_MODE THEN CURRENT_STMT = 1; 


THE DSTSK_RESET_LINUM_INCR COMMAND 


This command resets the current Line number increment value to 1. If 
statement mode is set, the current statement number is set to 1 as well. 
These are the semantics: 


CURRENT_INCR = 1; i 
IF CURRENT_STMT_MODE THEN CURRENT_STMT = 1; 


THE DSTSK_BEG_STMT_MODE COMMAND 


This command sets statement mode, meaning that subsequent Delta-PC com- 
mands will increment the current statement number within the current 
Line and not the current line itself. This command is only allowed in 
the Line-open gt pce. Statement mode can optionally be used by languages 
that have multiple Stasenents por Line. This command also set the cur- 


rent statement number to 1. ese are the semantics: 


IF CURRENT MARK NEQ LINE_OPEN THEN SIGNAL(Invalid DST Record); 
CURRENT_STAT_MODE = TRUE; 
CURRENT_STMT = 1; 


THE DSTSK_END_STMT_MODE COMMAND 


This command clears statement mode so that that subsequent Delta-PC com- 
mands will again increment the current Line number, not the statement 
number. The cqanene also set the current statement number to 1. These 
are the semantics: 


CURRENT_STMT_MODE = FALSE; 
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in the unsigned word that follows the command code. The command should 
only be used when statement mode is set. These are the semantics: 


CURRENT_STMT = PC_COMMANDCNEXT_UNS_WORD); 


THE DSTSK_SET_PC COMMAND 


wate command sets the current PC value to be the value specified in the 
uns pned byte follow ng the command code added to the start address of 
the ouest=oserees routine in the current module. This comand s only 
allowed in the | cs: 


RENLSSSLEALANVSS 


. ' ° . 
; ? 4 CURRENT_STMT = 1; ; 
; : ry } ; 
3 4 “8 THE DSTSK_SET_LINUM_B COMMAND : 
: 4545 i : 
3; § r4] ' This command sets the current Line number to the value specified in the 3 
: : is unsigned byte that follows the command code. These are the semantics: : 
: 454 i 
; ? ’ CURRENT_LINE = PC_COMMANDCNEXT_UNS_BYTE]; : 
i : 
: 4554 THE DSTSK_SET_LINUM COMMAND ; 
oo : 
; res i This command sets the current Line number to the value specified in the ; 
: $228 8 ‘unsigned word that follows the command code. These are the semantics: : 
: 4560 ; 
3 361 5 CURRENT_LINE = PC_COMMANDCNEXT_UNS_WORD]; : 
ct : 
: 4568 o THE DSTSK_SET_LINUM_L COMMAND - ; 
i; 2869 pi 
3 568 ! This command sets the current Line number to the value specified in the : 
: 288 0 longword that follows the command code. These are the semantics: : 
: 4571 i ; 
; 276 CURRENT_LINE = PC_COMMANDCNEXT_UNS_LONG]; :. 
Be BY : 
; 276 i THE DSTSK_SET_STMTNUM COMMAND ; 
BRB : : 
3 7 ! This command sets the current statement number to the value specified : 
. ] . 
; i 
7 ' . 
i ° 
4 i r 
; i ; 
. 1 . 
; i ; 
3 : 3 
7 ' . 
; i ; 
; i ; 
3 : 
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IF CURRENT_MARK 
CURRENT_PC7= ST 
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NEQ LINE CLOSED THEN SIGNAL(In 


val ie DST Record); 
ART_PC + PC_COMMANDCNEXT_UNS_BYTEJ; 


THE DSTSK_SET_PC_W COMMAND 


This command sets the c 
unsigned word followin 
the lowe s~operess rou 
allowed in the Line-clo 


IF CURRENT_MARK 
CURRENT_PC7= ST 


urrent PC value to be the value specified in the 

the command code added to the start address of 
ine in the current module. This comneng is only 
sed state. These are the formal semantics: 


NEQ LINE CLOSED THEN ares “ingest DST Record); 
ART_PC + PBC_COMMANDCNEXT_UNS_WORDJ; 


THE DSTSK_SET_PC_L COMMAND 


This command sets the c 
lLongword following the 
lowest-address routine 
allowed in the Line-clo 


urrent PC value to be the value specified in the 
ommand code added to the start address of the 

n the current module. This command is only 

sed state. These are the formal semantics: 


IF CURRENT MARK NEQ LINE CLOSED THEN aye ‘faves ve DST Record); 


CURRENT_PC7= START_PC + PC_COMMANDCNEXT_UNS_LONG 


THE DSTSK_SET_ABS_PC COMMAND 


command sets the current PC value to be the absolute address speci- 


This 
fied in the longword fo 
allowed in the line-clo 


IF CURRENT_MARK 


CURRENT_PC = PC_COMMAND 


THE DSTSK_TERM COMMAND 


This command terminates 
qurrent routine or othe 
n the last ine spect? 
command specifies how m 
Terminate command is ne 
-@., how many bytes re) 
current program unit). 


Llowing the command code. This command is only 
sed state. These are the formal semantics: 


NEQ Lie CLOSED THEN SteUs Cinval td DST Record); 
REXT_UNS_I.ONGJ; 


the PC-Correlation command sequence for the 
rf program unit and specifies fhe number o bytes 
ied by a Delta-PC command. Since the Delta-PC 
any bytes precede the Line being def ned the 
eed © say how many bytes are in that Line 
l increment the PC to the first byte past the 
The number of bytes in the last Line is speci- 
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fied by the unsigned byte following the command code. This command also 
sets the lLine-closed state. These are the semantics of the command: 


CURRENT_PC = CURRENT PC + PC_COMMANDCNEXT_UNS_BYTE); 
CURRENT_MARK = LINE_CLOSED; ¢ 


THE DSTSK_TERM_W COMMAND 


This command terminates the PC-Correlation command sequence for the cur- 
rent routine or other program unit and specifies the number of aytes in 
the Last Line of that program unit. It is a variant of the DSTSK_TERM 

command described above. The number of bytes in the last line is speci- 
fied by the unsigned word following the command code. This command also 
sets the Line-closed state. These are the semantics of the command: 


CURRENT_PC = CURRENT_PC + PC_COMMANDCNEXT_UNS_WORD]J; 
CURRENT_MARK = LINE_CLOSED; ~ 


THE DSTSK_TERM_L COMMAND 


This command terminates the PC-Correlation command sequence for the cur- 
rent routine or other program unit and specifies the number of bytes in 
the Last Line of that program unit. It is a variant of the DSTSK_TERM 
command described above. The number of bytes in the last Line is speci- 
fied by the longword following the command code. This command also sets 
the Line-closed state. These are the semantics of the command: 


CURRENT_PC = CURRENT PC + PC_COMMANDCNEXT_UNS_LONG]; 
CURRENT_MARK = LINE_CLOSED; 


: END OF LINE NUMBER PC-CORRELATION DST RECORD DESCRIPTION. 
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SOURCE FILE CORRELATION 
DST RECORDS 


The Source File Correlation DST record is used to specify the correla- 


’ tion between Listing Line numbers on the one hand and source files and 


source file record numbers on the other. These records enable DEBUG 
to display source Lines during the debugging session. 


The Source File Correlation DST record has the following format: 


¢eeeceece O00 000000005528 SSS SSS SSS SSS SCOSS ESO SESS SSSS eeeeeeooeoren + 
! DST$SB_LENGTH H 
H DSTSB_TYPE (= DSTSK_SOURCE) ; 
A variable number of 
Source File Correlation commands 
fecwneeennee oncnnnnnnennnnnnnennnnennenennnnnnnnnnnnnncenennne ; 


After the length and DST type bytes, the record consists of a sequence 
of Source File Correlation commands. These commands specify what source 
files contributed source Lines to this module ag¢ how the module's List- 
ing Line numbers are Lined up with the source files and record numbers 
within those source files. he available commands are described indi- 
vidually below. 


If the Source File Correlation commands needed to fully describe the 
current module will not fit in a single Source Line Correlation DST 

record, they can be spread over any number of such DST records. These 
records will be processed epquens tat te. in the order that they appear, 
until there are no more such records for the current module. 


The purpose of the Source File Correlation commands is to allow DEBUG 
to construct a table of correlations between Line num ore and source 
records. A ‘Line number’’ in this context means the Listing Line num- 
ber. This is the Line number which is printed in the program biat ing 
and is output to the PC-Correlation DST records by the comp ier. (PC- 
Correlation DST records correlate Listing Line numbers with Program 
Counter values.) A corresponding source Line is identified by two 
things: a source file and a record number within that source file. 


The semantics of the Source File Correlation commands can be understood 
in terms of manipulating three state variables and issuing one command. 
The three state variables are: 


LINE_NUM == The syrrent Listing Line number. 
SRC_FILE -- The File ID of the current source file, 
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i.e. a small integer uniquely defining 
the source file. 
SRC_REC == The record number (in the RMS sense) in 


the current source file of the current 
source Line. 


LINE NUM is assumed to have an initial value of 1 while SRC_FILE and 
SRC_REC are initially undefined. The one command is: 


DEFINE(LINE_NUM, SRC_FILE, SRC_REC) 


This command declares that Line number LINE ue is asege tated with the 
source line at record number SRC_REC in the file specified by SRC_FILE. 


Given-this, the fone itor must outgut @ sequence of Source File Correla- 
tion commands which cause LINE_NUM, SRC_FILE, and SRC_REC to be set up 
M and which cause the proper DEF INE operations to be issued 
to allow DEBUG to generate the correct Line number to source record 
= correlation table. (DEBUG — not ghee ge generate the full table, 
but it must be able to generate ~ part of such a table it needs.) 
The semantics of each Source File Correlation command is described 


appropriatel 


below in terms of these state variables and commands. 
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' 
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' 

' 

' 

' 

' 

J 

' 

' 

' 

' 

' 

' 

' 

' 

: Line numbers must be DEFINEd in sequential otder, from lowest Line 
: number to highest line number, in the Source File Correlation commands 
: for one module. The source records these line numbers correlate with 
may be in any order, of course. 
' 

' 

' 

' 

' 

' 

' 

' 

' 

' 

' 

J 

4 

' 

' 

' 

' 

' 

' 

4 

F 


It should be clear from what follows that the source for one module may 
come from many source files. This can be caused by plus-lists on the 
compiler command (e.g., SFORTRAN/DEBUG A+B+C) and by INCLUDE statements 
in the source. Also, source lines may come from modules within source 
libraries as well as from independent source files. 
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vention, but DEBUG's default behavior is that form feed records are 
ignored in sources files. They are not displayed and they do not count 
toward the source file record number of subsequent source records. To 
aane DEBUG count such records, the DSTSK_SRC_FORMFEED command must be 
used. 


i Define the location of the first command in the DST record. 


IELD DSTSSOURCE_FIELDS = 
Pa tSA_SRC_FIRST_CRD = (€ 2, A. 1 ! Location of first command in record 


: Define the command codes for all the Source File Correlation commands. 
LITERAL 


Od ed od dd IO 
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Minimum command code for og es 


Declare a source 


VSp5SSDUA28 LT 


for th mor ule 


Set the current source file (word 
Set source record number (lon sO 
Set peur ge Ay oly number (wor 

get List ne number (longword) 
Set listing Line number (word) 


Increment listing 
Unused--available 
Unused--available 
Define N separate 
Define N vat table 
Unused--available 
Unused--available 
Unused--available 


ine number (byte) 
or future use 
or susure use 


Lines (word) 


ines (byte) 

~ i use 

ad future use 
r future use 


WiWrorofororofrororornyd 
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Unused--avai lable wa future use 
Count Form-Feeds as source records 
Maximum command code for CASE ranges 


OO--.-.-.-90----GVoC0"U"0"0"0"0 


now 
~+— 
PWM 
xx 
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Od td dd 
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_SRC_FORMFEED 
“SRC"MAX_CMD 


! Define the fields of the Source Line Correlation commands. Also define the 
corresponding declaration macros. 
FIELD OSTEIAC COMMAND FIELDS = 

1 


Field common to all Source File Correlation commands. 
DSTSB_SRC_COMMAND =C{C0, 86.1], 
The fields of the Declare Source File command. 


DSTSB SRC DF _ LENGTH 
AGS 
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! Command code 


e{i.8. ]. : Length of this command 

DSTS$B_SRC_ = » & de ' Flag ot teroceseryed ets 
DSTS$W_SRC_DF_FILEID = » UW. i. ' Source file's File 
DST$Q_SRC_DF_RMS_CDT = « &, Be ! Creation date and t a or mod- 

; ule insertion date and time 
DSTSL_SRC_DF _RMS_EBK = 13. L_ J]. ! End-of-File block number 
DSTS$W_SRC_DF_RMS_FFB =C 17, WJ, ! First Free Byte in EOF block 
DST$B_SRC_DF_RMS_RFO =(€ 19, 8B. J, ! Record and File Organization 
DST$B_SRC_DF_FILENAME = $y. B- J, ! Source file name counted ASCII 
DSTSA_SRC_DF_FILENAME = A de = (CI (count byte, string addr) 


i Fields used to access information in all other commands. 


i 

DSTSL _SRC_UNSLONG efi. bt. i. ! Unsigned Lenquere parameter 
DST$W_SRC_UNSWORD ={ 1, Ww i Unsigned word parameter 

ps 188. SRC_UNSBYTE ={€ 1, B. i Unsigned byte parameter 


: Declare trailer field in the Declare Source File command. 
FIELD DSTSSRC DECLFILE_TRLR_FIELDS = 


DS TSB. SRC_DF_LIBMODNAME = f 0, BL : ! Module name counted ASCII 
DSTSA_SRC_DF-LIBMODNAME = [ 1, A_ i (count byte, string addr) 


2) 
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Correlation command and trailer blocks. 


1 
1 


TES; 
' Declaration macros for Source File 
M 


MACRO 


pn fw la lala lololo) 
Or-DOO-—ewm 


Booornrr _ 
3.000.000 00 00 
Troster 
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DST$W_SRC_DF_FILEID = The one-word ‘File ID’ of ghis. ource file. thts 
ryt » which can Later be used in the Set File comman 
iler assigns to each Sues 


y9 unique number which the com 
fi te y, ch santelbutes source | pes “fo the current modul TF ac 
source file thus has a number (th le ID) and is identified b 
that See in the Set File CDStse gre _SETFILE) command. 


DSTSQ_SRC_DF_RMS_CDT = The greotion @ date and time of this source file. 
This quadword quantity should be retr eved with a SXABDAT 
extended attribute block from RMS via SOPEN oe SDISPLAY 

system service. The creation date Ay ; me should be taken 
from the XABSQ_CDT field of the XAB. 


If the source file is a mo dule in , source Library. his field 
should contain the sodelat s Insertion Date and T n the Lib- 
rary. This value should be retrieved with the rar SET_MODULE 


: aBre 8 ' DECLARE SOURCE FILE (DSTSK_SRC_DECLFILE) ; 
: 4876 : 
: 1859 ' This command declares a source file which contributes source lines to ; 
; tas ! the current module. It declares the name of the file, its creation j 
; 487 : date and time ~, yor tous other attributes. The command also assigns ; 
3 4880 : @ one-word ' "Ftte | to this source file. This is the format of the ; 
; rete Declare Fe ete ete command: ; 
; ret T + ; 
4 . eeeeceeeceeen eeeeeoeoen Sen mae aan namo ne nmoaace o ee eeeeneeeoeoea wi woe mee + é 
; $885 j byte DBGSB_SRC_COMMAND (= “DSTSK =SRC_DECLFILE) i : 
; 4887 0 | byte i DSTSB_SRC_DF <LENGTH ; : 
3 ' eer en ree eee en anmecenmnence wasceoscossecoeasoeoecce ene ener ee eecee + e 
3 re +4 8 byte H DSTSB_ SRC OF FLAGS } : 
3 LESSORS OOOO OOOO OOOO seeeeeeeeeesees eee ese eon or oees + 4 
; rt: 8 } word i DSTSw_ SRC OF -FILEID : 3 
; 5 SS SS SSS SSS SSS SS ee eeseeeeoeeoooeoaen + D4 
: rt tty 8 quad ! DSTSQ_ SRC “OF “RMS COT. ' Ps 
3 LEE SK OKO ORO OOOO OSS OS SSS SSS eee eeseeeeseseeseesooes + P+ 
; tbe 8 } Long H DSTSL_ SRC OF _RMS “EBK H ; 
: 4897 9 | word i DSTSW_SRC_DF_RMS_FFB ; : 
3 H 228 SS SSS SSS SSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSESSEESESEEOSESZEEES + P 
: re 344 8 byte ‘ __DSTSB_ SRC -PF RMS _RFO H ; 
s + EE RO OM OOOO OOS SSS SSS SSeS esses eseeeeeeeeee + @ 
: read var H __DSTSB_ SRC “OF “FILENAME H , 
: 4908 0 ivar DST$B_SRC_DF _L IBMODNAME ; ; 
3 4904 0 ' ¢eeecocrwenas ececeece SSS OT Se BEER HOO EO RO Oe RB eM OOO OOM Bee + é 
wed ; 
3 4907 9 The fields in this command are the following: : 
: 4909 0 i DST$B_SRC_DF_LENGTH = The Length of this command, i.e. the number of ; 
: reat 8 bytes remaining in the command after this fie : 
: 4912 0 i DSTSB_SRC_DF_FLAGS - Bit flags. This field is reserved for future use. 3 
; 4913 0 ' At present this field Must Be Zero. 3 
; 4914 8 : 
: ie 8 
. i : 
. 1! 

; i 

. ' 

° i 

; i 

. 1 

. ' 

4 i 

; i 

3 ! 
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Librarian call. The Library file's creation date is not used. 


DSTSL_SRC_DF_RMS_EBK = The End-of-File block number for ny apoures 
fTle. This Longuoré Quantity should be reyr rieved wi 
SXABFHC extended attibute block from aoe via the sbPEN or 
SDISPLAY system service. The End-of-File block number should 
be taken from the XABSL_EBK field of the XAB. 


This field should be zero for modules in source Libraries. 


DSTSW_SRC_DF_RMS_FFB = The first free byte of the End-of-File block 
for Ehis’source file. This word cupnt ty should be retrieved 
with a SXABFHC extended attribute block from RMS via the SOPEN 
or SDISPLAY system service. The first free byte volue should 
be taken from the XABSW_FFB Held of the XAB. 


This field should be zero for modules in source Libraries. 


DST$B_ ™ _DF_RMS_RFO = The file organization and record format of this 
Ource file. This byte value should be bets eved with a 
SXABFHC extended attribute Me || from RMS via the SOPEN’ or 
SDISPLAY system service. e file organization and record 
format should be taken ne the XABSB_RFO field of the XAB. 


This field should be zero for modules in source Libraries. 


DSTSB_SRC_DF_FILENAME = The full filename of the source file. This is 
the fully specified filename, Sparsete with device name and 
cerelen & er, in which al d cards and logical names have 
been resolved. This strin should be retrieved with a SNAM 
block from RMS via the SOPEN or SSEARCH fetes, gorviee, The 
gosires Ryg ek is the ‘Resultant String’ speci 1 
$B_RSS, and NAMSB_RSL fields of io a bloc 

eee" the Arie name is represented as a Counted ASCII Rosy la 
.one=byte character count followed by the name string). 


DSTSB_SRC_DF_LIBMODNAME = The source Ry A nodule name (if applicable) 
of the null string. If the s actually a module in 
a source library, the DST$B_ SRC _DF _FILENARE "736 of ves the 
filename of the source Library and the DST$B_SRC_DF_LIBMODNAME 
field gives the name o the source module within t library. 
If the source file does not come from a source | ry, this 
field (DST$B_SRC_DF “LIBMODNANE ) contains the nul ero-Length) 


ha 
(er 
strine. This fiéld is represented as a Counted ASCII string. 
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SET SOURCE FILE (DSTSK_SRC_SETFILE) 


————-—--—-——, 


This command sets the current source file to the file denoted by she 


one-word file ID given in the command. The set file is then une 
from which further source lines are taken when the correspond ng { 
ing Lines are defined. This is the format of the command: 


pme er seme en een enna enn coo aane SMS ED arom emma ee wen econ et oe mms eae es wma $ 


; ; 
' DSTSw_ SRC “UNSWORD: “The File ID of ch iced source file H 
The semantics of this command is: 

SRC_FILE := file ID from command 


SRC_REC := set to current source record for this 
source file 


SET SOURCE RECORD NUMBER LONG (DSTSK_SRC_SETREC_L) 


This command sets the current source file record number to the longword 


value specified in the command. Its format is: 


otaelteeteitaneinetbadieintiateiednetiatar heeded  e 


fweecoceseneenesenewweeessoesesswsossoeseseooeoeseceoesecceescose 


The semantics of this command is: 
SRC_REC := longword value from command 
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SET SOURCE RECORD NUMBER WORD (DSTSK_SRC_SETREC_W) 


This command set the current sour 


ce file record number to the word 
value specified in the command. it i 


$s thus , more compact form of 
$: 


the DSTSK_SRC_SETREC_L command. s format 

Femme e eee ee ee ee eee ee eee ee eee eee eee sees eee sees eeeeeeeeeeeeescoece + 
byte | DBG$B_SRC_COMMAND (= DSTSK_SRC_SETREC_W) H 
word | DSTS$SW_SRC_UNSWORD: The desired new source record number ' 


emer mt etree er ee eee ee ee me em mee twee em ee meee eee ewe ew mmo emo ome e eee eo eon + 


The semantics of this command is: 
SRC_REC := word value from command 


SET LINE NUMBER LONG (DSTSK_SRC_SETLNUM_L) 


This command set the current Listing Line number to a longword value 
specified in the command. Its format is: 


+ z 
byte ! DBGSB_SRC_COMMAND (= DSTSK_SRC_SETLNUM_L) 
long } 


PP 8 OS SSS SS SS SSS SS SSS SS SSS SSS SSS SSSSSS SOS SS SSS Sees eeeeeeen} 


The semantics of this command is: 
LINE_NUM := longword value in commmand 
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SET LINE NUMBER WORD (DSTSK_SRC_SETLNUM_W) 


This command sets the current Listin ne number to a one-word value 
specified in the command. Its forma 


OOoCeco 
Vv 


FUSISISISISISIVI 


SRSSS 


FW" OOONOuUS 


; : H 
o i ; 
; ; 
° i P 
; i ; 
; } : 
; | : 
r4 1 : 
3 3 { byte | _._____DBGSB_SRC_COMMAND (= DSTSK_SRC_SETLNUM_ W) i 
; 4 i word | DSTSW_SRC_UNSWORD: The desired listing Line number i 
3 3068 The semantics of this command is: : 
; $96 i LINE_NUM := word value in command : 
; 5071 ! : 
3 2076 ! : 
a Sar, ! 3 
: 5073 INCREMENT LINE NUMBER BYTE (DSTSK_SRC_INCRLNUM_B) : 
: 5076 i 3 
i fare ! This command increments the current isting Line number by a one-byte F 
; 5079 value specified in the command. Its forma : : 
: 5080 ; 
; ©5081 : salah ate eee aha netetetataabababetatatabateatetabanetenabetebabeneeneteneenaten o-+ 3 
: 208 byte ! DBGS$B_ SRC _ COMMAND ( “DSTSK _SRC_ INCRLNUM_ B) ! : 
; o0ae 8 byte H DST$B_ SRC UNSBYTE: The desired Listing Line” number increment i; : 
Rc § i ; 
; 2089 : 3 
3 is The semantics of this command is: : 
:; 5090 0 i LINE_NUM := LINE_NUM + byte value in command ; 
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COUNT FORM-FEEDS AS SOURCE RECORDS (DSTSK_SRC_FORMFEED) 


This command spec ities a DEBUG should count source records which 
consists of nothing but a Form-Feed character (CNTL-L) as being 
distinct, numbered source a og In some Languages . such records 
are not rons (cores to be soures nes; instead they are regarded as 
control informat on. The compiler then eee not assign Line numbers 
hes ee and DEBUG ignores them complete Oa a ore ~ + displayed 

| of A source and they do not contrib he source record 
oll er ng ource files. However, if the bul K ore FORMFEED command 
is speci ti n the Source File perretet on OST Record for a module, 
then such -: ords count as normal records; they can be displayed and 
they are assigned source file record numbers. 


If used, this command must appear before any commands that actually 
define source lines. Making it the first command in the first 
Source File Correlation Record for the module is a good choice. 


¢oeweooeeeceseoa oy were eee Eee OMe ee eee + 


byte } DBG$B_ SRC_ ~ COMMAND (= DSTSK_SRC _FORMFEED) 


The semantics of th s command is to set a mode flag which says to 
count Form-Feed records as normal records. The default behavior 
is to ignore Form-Feed records. 
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DEFINE N LINES WORD (DSTSK_SRC_DEFLINES_w) 


This coapend defines the source file and source record numbers for 
a specified number of Listing Line numbers. The specified number is 
given by a one-word count in the command. The command format is: 


Pewee ee eee ee ee eee ee eee ee eee eee eee eee See ee eeeeseeseeeeeeseooeeosn} 


byte i DBGSB_SRC_COMMAND (= DSTSK_SRC_DEFLINES_W) 


booceocoeses eseeceee Se ee eee eeeeeoeeaneea SS SS SS SS SS SSS SSS SSSSeeeeanea ee aome 


word H DST$W_SRC_UNSWORD: The number of Lines to define H 


eececeeecen wt rm mee meme et mmm ee mem mm me mm ee eee eee eee wm ee eee meee wee + 
The semantics of this command is: 
DO the museer of times specified in the command: 
DEFINE(LINE_NUM, S.XC_FILE, SRC_REC); 
LIN € NUM"+ 1; 


= LI 


E_NUM 
SRC_LREC := SRC_REC * 1; 
END; 


DEFINE N LINES BYTE (DSTSK_SRC_DEFLINES_B) 


This command defines the source file and source record number for 

a specified number of Listing Line numbers. The specified number is 
given by a one-byte count in the command. This is thus a more compact 
orm of the DSTSK_SRC_DEFLINES_W command. Its format is: 


termes ecen en sone eoane eee enmre nm ecoe oe were seen eww noc em oma warn ncaa s + 


byte ; DBGS$B_SRC_COMMAND (= DSTSK_SRC_DEFLINES_B) 


byte H 


The semantics of this command is: 


LINO ODNO NE WIN $ O ODNOAUE WN SO ODDNOUF WN SO OONOULSWN OO” 


DO the number of times specified in the command: 


DIAL AD LAAN III III EE EES BEE BEAN ANA AANA III III — 


5 
66 DEF INE (LINE_NUM SRC FILE, SRC_REC); 
LINE_NUM :="LINE_NUM™+ 1; 
$8 SRC _REC := SRC_REC + 1; 


ee ee ce ce ce a ee ee ce ee ce ce ee ee ce ce ce ce ce ee ce ce cD Dc ee ce ce cD ee ce ce ce ee ce cD ce ee ed ee ee 
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! END OF SOURCE FILE CORRELATION DST RECORD DESCRIPTION. 
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THE DEFINITION LINE NUMBER 
DST RECORD 


NOTE: THIS DST RECORD IS NOT SUPPORTED BY DEBUG V4.0. 


The pyc iate ton Line Number DST record s oc it igs the Listing Line number 

at which a data: symbol or other object defined or sec saree The 

intent is to make use of this information in future DEBUG Ggqmands so 

that a oye er can see the declaration source Line for sper fied symbol. 

The Definition Line Number DST record must immed ateLy follow the data 

oy! fecere of the data object whose Line of definition is being speci- 
ed. 


This is the format of the Definition Line Number DST record: 


H DSTSB_LENGTH (= 6) i 
{aie oF ta 
Fscanintitiepectocanet tet. Et, SM seni 
icaken mannnnnnnnnPSTSLDEFSLMINSLINE al 


Define the fields of the Definition Line Number DST record. The unused byte 
in the DST record is reserved for future use. 


FIELD esToer -LNUM_FIELDS = 


Osts._ DEF_LNUM_LINE = C 3, L_ ] ! The definition Line number 
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Page 119 
. al 
THE STATIC LINK OST RECORD 


BKDST.REQ;1 0) 


The Static Link est recere specifies the ‘Static Link’’ for a routine. 
The Static Link is a pe nter to the VAX Rt lL frame for the proper up- 
tYon of srvecet ten oft peer routine within wh S the present nvoca- 

~ of he present routine is nested. The Static Link is thus used 

EBuc does ype Leve addressing in response to user commands. A 

etic Link DST Record tna onwaye uttne-End with she soy routine 
within whose Routine-Begin Routine-End records it i nested. The 
Static Link DST eegore ts opt onal--it need not Pg yore y languages 
or for routines which do not keep track of static Links in their run- 
time environments. In fact, the Static Link DST record only makes a 
difference for recursive routines that pass routines as parameters, a 
fairly obscure situation. 


This is the format of the Static Link DST record: 


i byte 
i var 


+ 
“DSTSA. SL “VALSPEC 

A DST Value Specification Giving the Value of the 
Static Link, i.e. the FP Value of the Routine Invocation 
Statically Up-Scope from this Scope 

; 


i Define the fields of the Static Link DST record. : 


' 
' 
! 
' 
' 
! 
1 
1 
1 
' 
' 
' 
' 
1 
' 
1 
' 
! 
1 
' 
' 
byte 
] 
i] 
1 
i] 
' 
1 
i] 
1 
' 
' 
' 
' 
' 
' 
| 
' 
' 
F 


FIELD DSTSSTATLINK_FIELDS = 


DSTSA_SL_VALSPEC =(€2, A, ] ' Location of Value Spec giving 
TES i the up-scope FP value 
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THE PROLOG DST RECORD 


DPUDVIVIVIVIUIV IV IV IV IVSVIVSVSUDVSVSVSVSVSTSVSISISIS ISVS ISIS ISIS ISSO 
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before data objects can be 
from DEBUG. Such prolog code typicall Sets up stack locations and 


tracepoints requested by the user. If specified, the pretog DST 
record is counted as belonging with the nearest Routine Begin or Entry 
Point DST record before it, not counting nested routines. Placing 
the Prolog DST record immediately after the Routine Begin or Entry 
This is the format of the Prolog DST record: 
eSeeeeee weet emer eter eet em em mmm meee meme em eee em me em meme wees eee eee = + 

byte : DSTSB_LENGTH (=5) H 

byte H DSTSB_TYPE (= DSTSK_PROLOG) : 

long } DST$L_PROLOG_BKPT_ADDR H 

i Define the fields of the Prolog DST record. 
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IELD OSTSPROLOG_FIELDS = 
Fz) St PROLOG_OKPT ADDR =( 2, t.-) ! The routine breakpoint address 
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THE VERSTON NUMBER DST RECORD 


The Version Number DST record gives the version number of the compiler 
that congtiee ninnee current module. The Version Number DST Record must 

e nested within the Module begin and Module End DST Records for the 
aodule in question. +e » grerys this record except in apes al cases 
when it is necessary to distinguish between old and new versions of the 
compiler that generated a given object module. 


This is the format of the Version Number DST record: 


PSE OE OR OOS SSS SSS SAS SRO SO Ne + 
byte | DSTSB_LENGTH (= 3) } 
* byte Hl DSTSB_TYPE (= DSTSK “VERSION) | H 
byte H DSTSB_VERSION_MAJOR H 
byte : DST$B_VERSION_MINOR ! 
Define the fields of the Version Number DST record. 
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FIELD OS TOYERSICA,, FIELDS = 


DST$B_VERSION_MAJOR 


¢- S By ! The major version number 
pares VERSION_MINOR SS = ' Th 


e minor version number 
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; 
5 
; 
; 
; 
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THE COBOL GL 0 BAL ATTRIBUTE 

DST RECORD 


The COBOL Global Attribute DST record indicates that the symbol whose 
DST record sanegiately follows has the COBOL a tyobet attribute. This 
attribute specifies that the symbol is visible in nested COBOL scopes 
(routines) within the scope (routine) in which = oymnet is declared. 
Without this attribute, a symbol is only visible in its scope of decla- 


ute in 


' 

! 

1 

! 

' 

1 

1 

i] 

" 

t 

! 

! ration but not within any nested scopes. In this regard. ¢C of differs 
; from most other cengueges DEBUG thus needs to know this attrib 
order to implement 

! 
' 
' 
1 
1 
] 
! 
1 
! 
1 
! 
' 
' 
1 


he COBOL scope rules correctly. 

The COBOL Global Attribute DST record is only generated by the COBOL 
compiler... If it precedes the DST record for some symbol, that symbol 
is deemed to have the COBOL global attribute; if it omitted, the sym- 
bol is deemed not to have the global attribute. DEBUG ignores this 
attribute for all other Languages. 


This is the format of the COBOL Global Attribute DST record: 


CGOOOCOCOCOCOCOCSCOCOCOOOOCOOOOOOOOOOOCOO 
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; 28 8 THE OVERLOADED SYMBOL DST RECORD : 
; 6] 3 
; 68 ; NOTE: THIS DST RECORD IS NOT SUPPORTED BY DEBUG V4.0. ; 
; 65 8 The Overloaded Symbol DST record is used to indicate that a given : 
; : 28 ; symbol name is overloaded. The record indicates which other symbols ‘ 
: 67 0 : in the DST are possible resolutions to the overloading. It is used ; 
: 5 re 8 by the ADA compiler. : 
; 70 8 i n ADA, it is possible to have more than one routine of the same name : 
3 71 : n the same scope. If the routine name is R, DEBUG disambiguates the ; 
oS if 0 : individual ipetences f the overloaded routine name with the invented : 
; 6 |6Sars 69 : names R__1, R_ R__5. and so on. DEBUG requires the ADA compiler to ; 
>; 5374 0 : generate normal bsT"Fecords for these routines, using the invented : 
s Sore 8 ! names. DEBUG also requires the ADA compiler to generate the Overloaded ; 
; 2376 0 ! Symbol DST record with the original overloaded name ‘'R'’' in order to ; 
; 230f 8 inform DEBUG of the overloading. : 
: 5379 0 i After the Length and type fields, this record contains a Counted ASCII . 
; 5380 0 : string with the name of the overloaded symbol. res Loving the Counted : 
; peel @ ' ASCII string, there is a word field containing a count of the number ~ ; 
; 2a56 0 ' of overloaded instances of the name in this scope. Next there is a : 
:; Sse @ : vector of pointers, one for each instance, pointing to the DST records : 
>; 5384 0 ' for the instances of the overloaded symbol. These DST pointers consist ; 
; eee? 8 } of byte offsets relative to the start of the whole DST. ; 
: eet 8 ; This is the format of the Overloaded Symbol DST record: : 
aie tai 2 
; 391 0 i byte i ST$B_LENGTH ! ; 
; 5395 0 byte } DSTSB_TYPE (= DST$K_OVERLOAD) i ; 
; 3395 6 : byte } DST$B_OL_NAME : ; 
F 3399 8 i var H . nei : : 
: sa06 The Overloaded Symbol Name in ASCII : 
: 230 0 (The name's Length is given by DST$B_OL_NAME) : 
: 8208 Lhaulhdhputnqnidntintintiniioneseee occcusinintonemienonnninnies : 
; 404 ' word } DST$W_OL_COUNT H 

; 5405 i teenenneennnnne-- satuteianatatanbospeptae aSeenen------ a aa ala aa aaa aaa + 

3 106 } var} DSTSA_OL_VECTOR 

; rt : A Vector of Longword Pointers to the DST Records 

; $19 of the Symbols with Invented Names that Constitute | 

; tig the Instances of this Overloading 

> 5414 i 

3 415 ! teewwooowreneeneceene Doeewoerowccccecccocce Ceoccecococcccocosoce + 


E ae et ae ee ee 
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i Define the fields of the Overloaded Symbol DST record. 


\ 
i 
i 
i 
i 

F 


FIELD DSTSOVERLOAD_FIELDS = 
DSTSB_OL_NAME =([ 2, 8. J], ! Count byte of the overloaded symbol 
: name Counted ASCII strin 
DSTSA_OL_TRAILER= C 3, A_ J ! The trailer fields start. at this 
: location + .DST$B_OL_NAME 


TES; 
! Define the fields of the 0. rloaded Symbol DST record trailer portion. Also 
define the corresponding declaration macro. 
F1ELD OST ITVERL OND, TRLR_FIELDS = 

DST$W_OL_COUNT = f 0, WL ° ! Number of instances in this scope 


DSTSA_OL_VECTOR = [ 2, A i Vector of DST pointers to instances 
Tes of overloaded symbol 


DSTSOVERLOAD_TRLR = BLOCKC BYTE] FIELD(DSTSOVERLOAD_TRLR_FIELDS) 2%; 


! This is a short BLISS example of how the trailer fields are accessed: 


CAL ’ 
DSTPTR: REF DSTSRECORD, ! Pointer to DST record 
OVERLOAD_COUNT ! The number of overloadings 
OVERLOAD TRAILER: i Pointer to DST record trailer 
F BSTSOVERLOAD_ TRLR, ! 
REF VECTORE, LONG); ! instances of this overloading 


Here we assume that DSTPTR points to the Overloaded Symbol DST record. 


OVERLOAD_ TRAILER = DSTPTRCDSTSA_OL_TRALER] + cApereracesTse -OL_NAME]; 
OVERLOAD_C LOAD_TRAICERTDST$B_OL NT); 


' 
' 
' 
' 
' 
' 
' 
' 
OVERLOAD VECTOR: : Vector of DST-record pointers to the 
' 
' 
‘ 
' 
' 
: OUNT = .OVER 

: OVERLOAD_ VECTOR = OVERLOAD TRAILERCDSTSA_OL “VECTORS; 
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CONTINUATION DST RECORDS 


< 
oO 
- 


When the text of a Debug Symbol Table tocorg is Longer than 255 bytes, 
it is no ‘onger possible to hold that text in a single BS! record since 
the DSTSB_LENGTH field cannot hold a value larger than 255. In this 
case it iS necessary to generate the original DST record followed by 

as Beny Fons inuat ton DST records as popeneery f° hold the fu } text. 

The or ‘ nal DST record then holds at least 100 and at most 255 areee of 
text. Each Continuation DST record consists of the standard two-byte 
header followed by the continued text of the original DST record. 


This is the format of the Continuation DST record: 


Peewee m ewww meee meee eee wwe e ewww eww wew ecw eee ese eescceecsoccccec= + 
byte ‘ DSTSB_LENGTH H 
byte ! DSTSB_TYPE (= DSTSK_CONTIN) ' 
SO meee Bet eH OE Be SR Ses Se eH eee eee De PE SE EH ESB BOK Hem ee SH 
var 
The Continued Text of the Previous DST Record 
jnennehessuennenapendtechenngnmasnnesuagubenneescanseneneeieneen + 


DEBUG reconstitutes a continued DST record by Sonsgtonet tng the text 

of the first DST record with the text portions of its Continuation DST 
records. In effect, the first two bytes of each Continuation DST record 
are strip ed out. Any further interpretation of the DST text is then 
done on the concatenated copy. 


Certain kinds of DST records are not allowed to be continued with Con- 
tinuation DST records. These records are Module Begin, Routine Begin, 
Block Begin, Label, Label-or-Literal, Entry Point, SECT, Line Number 
PC-Corre ation, and Source File Correlation DST records. In addition, 
DST records with fixed sizes, such as Module End and Routine End DST 
records, are not allowed to be continued. Line Number PC-Correlation 
and Source File Correlation DST records cannot be continued with Con- 
tinuation DST records, but one can have multiple such records in one 
module; they can thus be continued, but through a different mechanism. 
The records that really need to be continued, such as Standard Data 
DST records and their variants (Descriptor Format and Trailing Value 
Specification Format records), Separate Type Specification DST records, 
and Type Specification DST records, can all be continued using the 
Continuation DST record mechanisa. 


Define the fields of the Continuation DST record. 
IELD DSTSCONTIN_FIELDS = 
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piSA.CONTIN = (2, AL] ! Address of continuation text 
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OBSOLETE DST RECORDS 


<= 


There are several obsolete DST records. These are records that were 

at one time generated by compilers, but are no longer used by any cur- 
rent version of any Digital compiler. Some of these records were not 
properly thought out and were abandoned when it was realized that their 
ntended uses could not be implemented. Others were at one time used 
and useful, but were generated by now-obsolete compilers. Such records 
are not generated by current compiler versions, and the capabilities 
they grey teed are now provided more general mechanisms in other DS 
records. 


None of the obsolete DST records should be ponpreses by any future 
compilers, and their use will not necessarily be supported by DEBUG. 


THE GLOBAL-IS-NEXT DST RECORD 


The Global-is-Next DST record is now obsolete. It consisted of just the 
DST$B_LENGTH byte and the DSTSB_TYPE byte. DSTSK_GLOBNXT was the type 
code. The purpose of this record was never properly thought out and 

no support for it was ever Tap Lenented. It should not be generated by 
any future compilers or compiler versions. 


THE EXTERNAL=IS-NEXT DST RECORD 


The External-is-Next DST record is now obsolete. It consisted of just 
the DSTSB_LENGTH byte and the DSTSB_TYPE byte. DSTSK_EXTRNXT was the 
type code. The purpose of this record was never pre erly thought out 
and no support for it was ever implemented. It should not be generated 
by any future compilers or compiler versions. 


THE THREADED-CODE PC-CORRELATION DST RECORD 


This DST record is identical in format to the Line Number PC-Correlation 
DST record except that the record type code is DSTSK_LINE_NUM_REL_R11. 
It was used by an obsolete COBOL compiler according fo legend” (thé memo- 
ries are a » aesy by now). The idea was that the threaded code gene- 
rated by this gone ler consisted of a vector of longwords where each 
songuere contained the address of ? run-time support routine to call. 
Register R11 pointed to the beginning of this vector. The code gene- 
rated for a source line thus consisted of some number of Longwor s 

with addresses to call (or perhaps jump to--the exact details are lost 
in the mists of time). The Line number PC-correlation information 
passed to DEBIG ¢ nsisted of Line numbers correlated with byte-offsets 
relative to R -@., to the start of the threaded code). Gree oints 
were placed on a specified Line by looking up the corresponding offset 


relative to R11 and then storing an address within DEBUG into that 

location. When the location was reached, DEBUG was entered. DEBUG 

coyie then convert the ‘'PC .@. the threaded-code location, back to 
Line number to announce the breakpoint. It is not clear how, or even 


o~n~ 
Wr—Ow0O°w 


FIPVSISISIIVIT 


a 
whether, tracing, stepping, and watchpoints were implemented. 
The Threaded-Code PC-Correlation DST record is no longer supported by 
2 5 DEBUG and should not be generated by any current or future compilers. 
58 
88 
8 THE COBOL HACK DST RECORD 
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The COBOL Hack DST record was at one time used to support formal argu- 
ments to COBOL procedures. It has now been superceded by the more 
general Value Specification mechanism, and is thus obsolete. It is 

no ager generated by the COBOL com filer, and it should not be gene- 
rated by any current or future compilers. Future versions of DEBUG 
may not support it. 


The fields of this record consist of the fields of the Standard Data 
DST record followed by a type field that specifies the data type and 
then a sequence of commands for the DEBUG stack machine. (See the sec- 
tion on Value Specifications for details on the DEBUG stack machine.) 
The result of interpreting the stack machine routine is the address of 
the object described by this record. The DST$B_VFLAGS and DSTSL_VALUE 
fields are zero unless the object has a descriptor. In this Latter 
case they specify the location of the descriptor. The result of the 
stack machine routine is placed in the DSCSA_POINTER field of the 
descriptor before it is used. In addition, Tf it is an array descrip- 
tor, the DSCS$A_AO field is added to the result of the stack machine 
routine and the result is placed in the DSC$A_A0 field before the 
descriptor is used. 
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The type field following the name field contains the VAX Standard Type 
Code of the object being described here. If the object also has a 
descriptor, its DSC$B_DTYPE field must agree with this code. 


The stack machine commands used in this context are those described 
in the section entitled ‘The DEBUG Stack Machine’’ in the chapter on 
DST Value Specifications. 


This is the format of the COBOL Hack DST record: 
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MACRO 


; 6 § : Se Se nee N STOR T ORNS RRR SS SSS SS TESS STINET SSSISITETS TAT OTOSSSS OSSD + 
; 6 ' byte J DSTSB_LENGTH ' 
3 624 ; FSR SRS SEES SETS SST SSSSORE SSSI ITT RISO TINT ONS ¢ 
: ? 5 byte ‘ DSTSB_TYPE (=DSTSK_COB_HACK) H 
: 56 : i byte | DSTSB_VFLAGS 
; 628 : a eee aaa ar aaa aia + 
; 629 ' long | DSTSL_VALUE H 
; 630 : aetna taal ta + 
; 631 ' byte | DSTSB_NAME ' 
; 6 ¢ : teececece sche eaeaeheieeeteeettanetetaatetateiatatatetatatatetatetaeateetatanaaanatel + 
; 6 ‘ var H ' 
; ¢ } The Name of the Data Symbol in ASCII 
; 9 ! (The name's Length is given by DSTSB_NAME) 
: i ' H 
: 8836 0 i teen nnnnnn nnn nnen nnn nen nnn n enn n nnn ennn-enn eee e nnn - eee ee eee eee + 
; 3640 i byte } DST$B_CH_TYPE : 
; see 0 ‘var | DSTSA_CH_STKRTN_ADDR 
; aete , } Instruction Sequence for the DEBUG Stack Machine 
: 5646 g i 
; 5647 ' : ' 
> 3648 0 : Gooeenwwennewns conwnnnnnennonocewnsosecososeneccesccesecoscesese + 
; Hits 0 ' 

ae | 

; 5652 6 i Define the fields of the Coboi Hack DST record. Also define the declaration 
$ rth 8 } macro for the trailer fields. 

3 65 FIELD DSTSCOB_HACK_F1ELDS = 

F 637 Fal tA CORMACK. FRLA =C€ 8, AL] ! Location of trailer fields 
: 5659 o ‘ 

H i FIELD OSTECK.TALA_FIELOS = 

; S663 0 DST$B_CH_TYPE = F 0, B }: ! VAX standard data type 
3 is Faron cM STRAT ADOR =(€ 1, AL ! Start of stack routine code 
eS 


Ect 


DSTSCH_TRLR = BLOCKC,BYTE] FIELD(DSTSCH_TRLR_FIELDS) 2%; 
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VALUE SPECIFICATION DST RECORDS , 


The Value yoet tt teat ton DST record contains nothing but a DST Value 
Specification. However, Shere appears to be no use for this record 
since all DST Value spect ications that are actually used appear in 
other DST records. s record was probably designed with some use 
in mind, but was then abandoned when better ways of addressing the 
original need were devised. DEBUG ignores this DST record, and it 
is believed that no compilers actually generate it. This 6ST record 
should not be generated by any future compilers. 


This is the format of the Value Specification DST record: 


tren ace mene arena e ae ee ee eS oe ee oe oe 2S SSS SSS SS SS SSSSZSSSSSSSSSSTSSHSSESSESZSESSEeS $ 


DST$B_LENGTH 
DSTSB_TYPE (= DSTSK_VALSPEC) 


peer meone ame ee SOB est ewn mE rence na mw meat emi mana wee mw e ee naman = 


byte 


var H 
A DST Value Specification 
+ 


Define the fields of the Value Specification DST record. 
IELD DSTSVALSPEC_FIELDS = 


DSTSA_VS_VALSPEC_ADDR = [ 2, A_ ] ' The start location of the 
TES } Value Specification 


' 
1 
' 
' 
i] 
' 
' 
' 
i] 
' 
' 
! 
1 
' 
] 
‘ 
' 
byte 
! 
! 
i] 
] 
' 
! 
' 
i] 
t 
1 
1 
' 
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n------- Symbols -------- 


P 
File Total idaded Percent Rabped 
-$255$DUA28: CTRACE .OBJISTRUCDEF .L32;1 32 5 15 7 


COMMAND QUALIFIERS 
BLISS/LIBRARY=L1IB$: TBKDST.L32/LIST=LIS$:TBKDST.LIS SRC$:TBKDST.REQ 


Time 99: 32-8 
eg +aes 0:44, 
Lines/CPU Min: 10775 
Cenenes/CPU-Nin: eer 
Memory Used: 82 p pages 
Liorery Precompilation Complete 


VAX=11 Bliss-32 V4.0-742 
Processing 
Time 


00:00.1 
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